# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
curl --request GET \
--url 'https://api.migration.powerdialer.ai/api/public/v2/custom-dispositions?limit=50' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"data": [
{
"id": 123,
"workspaceId": "org_example",
"name": "Follow up requested",
"mappedDispositions": [
"Positive"
],
"createdAt": "2026-10-12T12:00:00.000Z",
"updatedAt": "2026-10-12T12:00:00.000Z"
}
],
"nextCursor": null
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}List custom dispositions
Manage the shared custom dispositions in the API key’s workspace. Existing personal definitions remain available in the app and are not exposed or migrated by this endpoint. Requires dispositions:read.
Names are unique within the workspace. Invalid or built-in names and empty/unknown mappings return 400 invalid_request; duplicate names return 409 disposition_name_conflict. Guessed IDs outside the workspace return 404 not_found. Shared renames and deletes preserve historical call labels; mapping changes affect future saves only. These operations configure definitions and do not apply a disposition to a call or execute CRM, DNC or automation actions.
See custom disposition compatibility.
Ordered by ID. Follow nextCursor using after until null; limit is 1–200 (default 50). Personal and workspace keys read the same shared definitions in their workspace.
# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
curl --request GET \
--url 'https://api.migration.powerdialer.ai/api/public/v2/custom-dispositions?limit=50' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"data": [
{
"id": 123,
"workspaceId": "org_example",
"name": "Follow up requested",
"mappedDispositions": [
"Positive"
],
"createdAt": "2026-10-12T12:00:00.000Z",
"updatedAt": "2026-10-12T12:00:00.000Z"
}
],
"nextCursor": null
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Authorizations
Issued in Developers. Workspace/owner/scopes come from credential, never acting-user headers. API keys cannot manage API credentials.
Query Parameters
Exclusive numeric ID cursor. Omit or use 0 for the first page, then pass the previous nextCursor. Keep the same filters while paging.
0 <= x <= 2147483647Maximum items to return in one page, from 1 to 200. Defaults to 50. Smaller pages reduce response size; this is not a total-result limit.
1 <= x <= 200