# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
# Set this once per operation; reuse it with the same request after a timeout.
: "${POWERDIALER_REQUEST_ID:?Set POWERDIALER_REQUEST_ID to a new UUID for this operation}"
curl --request PUT \
--url 'https://api.migration.powerdialer.ai/api/public/v2/lists/456' \
--header "Authorization: Bearer $POWERDIALER_API_KEY" \
--header "Idempotency-Key: $POWERDIALER_REQUEST_ID" \
--header 'Content-Type: application/json' \
--data '{
"name": "October inbound leads",
"ownerId": "user_example",
"groupName": "Inbound"
}'{
"name": "October inbound leads",
"ownerId": "user_example",
"groupName": "Inbound",
"id": 456,
"orgId": "org_example",
"createdAt": "2026-10-08T12:00:00.000Z",
"updatedAt": "2026-10-08T12:00:00.000Z",
"contactsCount": 1
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Update a calling list
Rename a calling list, change its group or assign an allowed owner while keeping the same list ID. Requires lists:write. The current list must be visible to the credential; the requested owner must be a permitted current member of the same workspace.
Send the full list write shape with name and ownerId. Omit groupName or set it to null to clear the group. This is not a partial PATCH. Updating list details does not update contact fields or transfer the ownership of its contact records; list and contact access remain separate.
Persist an Idempotency-Key and keep the same method, path and body for retries. 404 not_found covers missing or inaccessible lists. 403 invalid_owner requires another permitted member. If a retry returns 409 idempotency_conflict, restore the original request or use a new key only for a new logical change.
See list management.
# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
# Set this once per operation; reuse it with the same request after a timeout.
: "${POWERDIALER_REQUEST_ID:?Set POWERDIALER_REQUEST_ID to a new UUID for this operation}"
curl --request PUT \
--url 'https://api.migration.powerdialer.ai/api/public/v2/lists/456' \
--header "Authorization: Bearer $POWERDIALER_API_KEY" \
--header "Idempotency-Key: $POWERDIALER_REQUEST_ID" \
--header 'Content-Type: application/json' \
--data '{
"name": "October inbound leads",
"ownerId": "user_example",
"groupName": "Inbound"
}'{
"name": "October inbound leads",
"ownerId": "user_example",
"groupName": "Inbound",
"id": 456,
"orgId": "org_example",
"createdAt": "2026-10-08T12:00:00.000Z",
"updatedAt": "2026-10-08T12:00:00.000Z",
"contactsCount": 1
}{
"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.
Headers
Persist one key for this logical operation before sending it. Reuse the same value only with the same method, path and body after a timeout. A changed request returns 409 idempotency_conflict; a matching retry returns the original response.
^[A-Za-z0-9._:-]{1,200}$Path Parameters
Numeric calling-list ID returned by POST /lists or GET /lists. The list must be visible to this credential.
1 <= x <= 2147483647Body
Display name for the calling list.
1 - 150Active workspace member who owns the list and is allowed by this key.
1 - 100Optional grouping label. Omission on PUT clears the stored label.
100Response
The updated list, or the saved response for an identical retry.
PowerDialer list ID. Use this integer in list URLs and analytics filters.
Calling-list display name.
PowerDialer member who owns this list.
Workspace identifier stored on the list.
Optional grouping label, or null.
List creation time in UTC.
Last list update time in UTC.
Stored total membership count for the list. It may exceed the contacts visible to a restricted key.