AXaxilioai
phones

Update a phone

Changed on

Changes the fields a customer may set on a dedicated phone the caller's org owns: its nickname. Returns the updated phone.

patch/phones/{phone_id}

Request

Path parameters

phone_idstring required

device identifier

Request body

$schemastring uri

A URL to the JSON Schema for this object.

nicknamestring required

New display name for the phone.

Example request

{
  "$schema": "/api/v1/PhoneUpdatePhoneRequest.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

created_atstring date-time required

When the phone record was created.

current_session_idstring nullable required

Session currently holding the phone, if allocated.

last_heartbeat_atstring date-time nullable required

Time of the phone's most recent heartbeat.

last_interaction_atstring date-time nullable required

Time of the most recent interaction on the phone.

locationstring nullable required

Physical hosting location of the phone.

model_idstring nullable required

Hardware model identifier.

model_namestring nullable required

Hardware model name.

nicknamestring nullable required

User-assigned nickname.

owner_organization_idstring nullable required

Owning organization, for private phones.

ownership_type'shared' | 'private' required

'shared' for pool phones, 'private' for dedicated rentals.

phone_idstring required

Phone identifier used by allocate and the phone APIs.

phone_namestring nullable required

Display name of the phone.

phone_numberstring nullable required

The phone's own number in E.164, for a dedicated phone your organization rents: what its SIM reports, or else the number its latest received text was sent to. Null when neither is known, and for shared phones.

phone_type'android' | 'iphone' | 'unknown' nullable required

Platform of the phone.

rental_expires_atstring date-time nullable required

When the current rental ends, for rented phones.

status'active' | 'inactive' | 'maintenance' | 'suspended' | 'recovering' | 'out_of_service' required

Fleet status of the phone. Only active is allocatable. inactive: unreachable, back on its next heartbeat. maintenance: planned work that releases itself. suspended: an administrative hold. recovering: being repaired automatically. out_of_service: needs a repair at the rack. Treat unknown values as unavailable.

updated_atstring date-time required

When the phone record was last updated.

Example response

{
  "$schema": "/api/v1/PhoneSummary.json"
}

Changes