Delete Disposition

curl --request DELETE \
  --url https://api.agents.timepay.ai/api/v1/dispositions/{id} \
  --header 'Authorization: <authorization>'

{
  "success": true,
  "message": "Disposition deleted successfully"
}

Delete Disposition

curl --request DELETE \
  --url https://api.agents.timepay.ai/api/v1/dispositions/{id} \
  --header 'Authorization: <authorization>'

{
  "success": true,
  "message": "Disposition deleted successfully"
}

Overview

Permanently delete a disposition from your organization.

Cannot delete dispositions in useYou cannot delete a disposition that is currently assigned to any disposition group. Remove the disposition from all groups first before deleting.

Headers

Authorization

string

required

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

Path Parameters

string

required

The unique identifier of the disposition to delete

Response

success

boolean

Indicates if the request was successful

message

string

Response message

{
  "success": true,
  "message": "Disposition deleted successfully"
}

Error Codes

Status	Description
`400`	Cannot delete - disposition is used in one or more groups
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Missing required permissions
`404`	Disposition not found
`500`	Internal server error

Update Disposition List Disposition Groups

​Overview

​Headers

​Path Parameters

​Response

​Error Codes

Overview

Headers

Path Parameters

Response

Error Codes