VOvoipbin
Service Agent

Register a push device

Changed on

Registers the push device of the calling agent, or refreshes it when the same token is already registered. The call is idempotent: both a new and a refreshed device return 200. The device always belongs to the authenticated agent; the owner is never taken from the request. A token that was registered by another agent is moved to the calling agent.

The push token is a credential and is never returned in any response.

Returns 400 when the platform is not supported, or when the token is empty or longer than 512 bytes.

post/service_agents/push_devices

Request

Request body

platform'android' required

The platform of the push device. Only android is supported.

tokenstring required

The push token issued to the app by the platform's push service. 1 to 512 bytes.

Example request

{
  "platform": "android",
  "token": "fcm-token-example-0123456789"
}

Response

The registered device.

idstring uuid

The device ID returned from POST /service_agents/push_devices.

customer_idstring uuid

The customer ID of the owner agent, returned from GET /service_agents/me.

agent_idstring uuid

The owner agent ID, returned from GET /service_agents/me.

platform'android'

The platform of the push device. Only android is supported.

tm_createstring date-time

When the device was first registered.

tm_updatestring date-time

When the device was last registered or refreshed.

Example response

{
  "id": "3f6c1d2e-8a4b-4c7d-9e10-5b2a7c8d9e01",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "agent_id": "2ddf1c90-bbc1-11ef-b991-1bd6ee52cbc5",
  "platform": "android",
  "tm_create": "2026-11-09T09:15:30.123456Z",
  "tm_update": "2026-11-09T09:15:30.123456Z"
}

Changes