Sign in
Call Commands

Remove call from a queue

Removes the call from the queue it is currently waiting in. The call remains active and can be directed with further call commands.

post/calls/{call_control_id}/actions/leave_queue

Path parameters

call_control_idstring required

Unique identifier and token for controlling the call

Request body

client_statestring

Use this field to add state to every subsequent webhook. It must be a valid Base-64 encoded string.

command_idstring

Use this field to avoid duplicate commands. Telnyx will ignore any command with the same command_id for the same call_control_id.

Example request

{
  "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
  "command_id": "891510ac-f3e4-11e8-af5b-de00688a4901"
}

Response

Successful response upon making a call control command.

Example response

{
  "data": {
    "result": "ok"
  }
}

Changes

Changed in 2 of the 61 revisions of this API.7

  • 1571b0380bd73See the full diff
    • ▲

      the response's body type/format changed from object/ to / for status default

      response-body-type-changed

    • ▲

      the errors/items/ response's property type/format changed from object/ to / for status default

      response-property-type-changed

    • ▲

      the errors/items/code response's property type/format changed from integer/int32 to string/integer for status default

      response-property-type-changed

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8f5f4e5379944See the full diff
    • ▲

      the response's body type/format changed from / to object/ for status default

      response-body-type-changed

    • ▲

      the errors/items/ response's property type/format changed from / to object/ for status default

      response-property-type-changed

    • ▲

      the errors/items/code response's property type/format changed from string/integer to integer/int32 for status default

      response-property-type-changed

    • ▲

      the errors/items/source/pointer response's property type/format changed from string/json-pointer to string/ for status default

      response-property-type-changed

    This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog