AXaxilioai
Phones

Release a phone

Changed on

Deallocates a phone the caller's org currently holds. The session is billed and the phone is torn down asynchronously. Pass session_id to end that session only: if the phone has already moved on to another session, nothing is released and the call still succeeds.

post/phones/{phone_id}:deallocate

Request

Path parameters

phone_idstring required

phone identifier to deallocate

Request body

session_idstring

End this session only. If the phone has already moved on to another session, nothing is released and the call still succeeds. Omit to end whatever session the phone holds.

Response

OK

agent_idstring

The agent whose run the released session ran; absent for an interactive session.

deallocated_atstring date-time

Timestamp when the device was released.

phone_idstring required

Released device's identifier.

session_idstring required

Session that was closed.

Changes

  • 62aa324803a7Revision changes
    • breaking

      removed the required property from the response with the status

    • info

      added the optional property to the response with the status

  • ecca093572e0Revision changes
    • info

      added optional request body

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status