Page Comparison

Sets the disposition code for the call. Specify the disposition code for the call in the query string parameter, callGuid.

Request Uri

POST v{v#}/{accountKey}/calls/{callGuid}/dispositionCode

Request Headers

Authorization (required)

This header requires an OAuth bearer token. For information on the bearer token, see How to use your bearer access token.

Content-Type (required)

application/json

Indicates that the media type sent by the client is JavaScript Object Notation (JSON).

application/xml

Indicates that the media type sent by the client is Extensible Markup Language (XML).

Examples

Set 'Wrong Number' disposition code for call 94e5928c-7f7e-4645-ad72-61010f906449 for agent 1234

curl -X POST "https://***.newvoicemedia.com/v0/a1b2c3d4e5/calls/94e5928c-7f7e-4645-ad72-61010f906449/dispositionCode" -d '{ "dispositionCode": "Wrong Number", "agentId": "1234" }' -H "Authorization: Bearer <ACCESS_TOKEN>" -H "Content-Type: application/json"

Successful calls return HTTP status code of 200, containing the following message and headers.

Example: Successful response

Returns HTTP Status Code 200 OK.

{
  "dispositionCode": "Wrong Number"
}

Example: Invalid request data

Returns HTTP Status Code 400.

• Invalid blank dispositionCode

{

  "message": "Disposition code field was expected. "

}

• Invalid dispositionCode: max length of disposition code value is 255 characters

{
 "message": "Disposition code excceeds 255 characters."
}

Example: Unknown call specified

Returns HTTP Status Code 404.

{

 "message": "The requested resource was not found."

}