# 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/123' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"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"
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Get a custom disposition
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.
# 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/123' \
--header "Authorization: Bearer $POWERDIALER_API_KEY"{
"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"
}{
"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.
Path Parameters
Numeric custom-disposition ID returned by POST /custom-dispositions or GET /custom-dispositions.
1 <= x <= 2147483647Response
Successful operation.
Stable custom disposition definition ID.
x >= 1Workspace that owns this shared definition.
Trimmed, case-sensitive label. Built-in names are reserved.
1 - 100Ordered built-in mappings. The first mapping drives CRM, DNC and automation. Duplicates are removed in order.
1 - 19 elementsNotDisposed, LeftVoicemail, Busy, Gatekeeper, NoAnswer, BadNumber, NotInService, Positive, Neutral, Negative, AnsweringMachine, WrongNumber, NotInterested, DoNotCall, NotAvailable, Sold, MeetingBooked, NoShow, PresentedNoSale