Update Reason Code

put

{protocol}://{server}{basePath}/accounts/{accountId}/communication-managers/{communicationManagerId}/reason-codes/{reasonCodeId}

This API requires the Account Administrator role.

"Update an existing Reason Code name, description and/or other properties."

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

accountId

string

required

length between 6 and 6

^[a-zA-Z]{6}$

The unique 6 character internal id that represents the customer account.

communicationManagerId

uuid

required

The unique id of the Communication Manager

reasonCodeId

uuid

required

The unique 36 character internal id for the reason code

Body Params

Represents the request body of an API to update a Reason Code.

codeName

string

required

length between 1 and 20

^[a-zA-Z\p{L}0-9]+([ ]*[a-zA-Z\p{L}0-9-\_\*\=\+\$\:\;\&\~\,\?\%\!\|\{\}\`\.\']+)*$

The name of the Reason Code. If code type is NOT_READY or LOGOUT, code name length must be up to 16 unicode characters and if code type is CALL_WORK_CODE, code name length must be up to 20 unicode characters.

codeNumber

string

length between 1 and 16

^[0-9][0-9]*$

The number of the Reason Code. If code type is NOT_READY, code number must be between 1 to 99. If code type is LOGOUT, code number must be between 1 to 9 and if code type is CALL_WORK_CODE, code number must be of 16 digits.

description

string

length between 0 and 1024

The description for the Reason Code

isInterruptible

boolean

Indicates if the Reason Code is interruptible. This is applicable to NOT READY Reason Codes.

systemDefinedAttributes

array of objects

length ≤ 5

Indicates if the Reason Code has additional system defined behavior. This is applicable to NOT READY Reason Codes. Only one Not Ready Reason Code shall be allowed to be marked as 'Work on Digital'. If a Not Ready Reason Code is marked as 'Work on Digital', it cannot be assigned any other system-defined attribute. At least one Not Ready Reason Code needs to be marked as 'Work on Digital'.

systemDefinedAttributes

Allowed:

organizationNodeId

string

length between 6 and 6

^[a-zA-Z]{6}$

Unique Id for Account or Node where Reason Code gets created

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

URL

Loading…

Response

Choose an example:

application/json

application/problem+json

202Accepted

400Constraint violation for accountId

401Unauthorized

403Forbidden

404Not Found

409Conflict

500All other application errors