Skip to main content
Update Disposition
curl --request PUT \
  --url https://api.agents.timepay.ai/api/v1/dispositions/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "priority": 123
}
'
{
  "success": true,
  "message": "Disposition updated successfully",
  "updatedFields": ["name", "priority"]
}

Overview

Update an existing disposition. Only the fields you provide will be updated; all other fields remain unchanged.

Headers

Authorization
string
required
Bearer token for authentication (e.g., Bearer <your_token>).

Path Parameters

id
string
required
The unique identifier of the disposition to update

Request Body

name
string
Disposition name (max 100 characters)
description
string
Disposition description (max 1000 characters)
priority
integer
Priority level from 0-1000

Response

success
boolean
Indicates if the request was successful
message
string
Response message
updatedFields
array
List of fields that were updated
{
  "success": true,
  "message": "Disposition updated successfully",
  "updatedFields": ["name", "priority"]
}

Error Codes

StatusDescription
400Validation error or no valid fields provided
401Unauthorized - Invalid or missing API key
403Forbidden - Missing required permissions
404Disposition not found
409A disposition with this name already exists
500Internal server error