Revoke own driver push-device registration

Revoke the selected device registration owned by this driver. This stops future notifications to the registration without ending duty or changing published work.

Authentication

Requires a driver bearer session. Administrator sessions and integration keys cannot perform this driver action.

Parameters

Request

No JSON request body is required.

Example request

Replace synthetic identifiers and credentials. Example dates, coordinates, revisions, and IDs are not production defaults. Read the workflow guide before making a write.

curl --request DELETE 'https://route-api.okok.space/api/v1/driver/push-devices/device-01' \
  --header 'Authorization: Bearer REPLACE_WITH_DRIVER_TOKEN'

Responses

Examples illustrate the documented shape; optional fields and current state can differ. JSON extraction/body-limit errors may be plain text.

204 · Successful response

No response body is defined for this status.

401 · Invalid/revoked driver session

application/json

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid/revoked driver session"
  }
}

{
  "$ref": "#/components/schemas/Error"
}

403 · Required driver permission denied

application/json

{
  "error": {
    "code": "unauthorized",
    "message": "Required driver permission denied"
  }
}

{
  "$ref": "#/components/schemas/Error"
}

404 · Not found in own business

application/json

{
  "error": {
    "code": "not_found",
    "message": "Not found in own business"
  }
}

{
  "$ref": "#/components/schemas/Error"
}

422 · Validation failed

application/json

{
  "error": {
    "code": "validation",
    "message": "Validation failed"
  }
}

{
  "$ref": "#/components/schemas/Error"
}

503 · Required infrastructure unavailable

application/json

{
  "error": {
    "code": "unavailable",
    "message": "Required infrastructure unavailable"
  }
}

{
  "$ref": "#/components/schemas/Error"
}