Índice de errores

Generado desde DialerDigital/core @ bbb8e373d900 (spec v0.151.0).

English: Error index.

Todo error de la API lleva el mismo sobre, {"error": {"code": "...", "message": "..."}}: ramifica por code, nunca por message (ver Errores y cumplimiento). Este índice se genera de la spec OpenAPI que vendoriza este sitio, así que no puede quedar por detrás de ella: un código sólo aparece aquí si la spec lo muestra en un ejemplo de respuesta o lo nombra junto a su estado HTTP.

161 códigos distintos, 161 pares código/estado.

Código	HTTP	Dónde lo muestra la spec	Mensaje de ejemplo
admin_target_forbidden	403	DELETE /v1/users/{id} POST /v1/users/{id}/enable	—
agent_unreachable	409	POST /v1/screen-monitor/sessions	—
api_key_limit	409	POST /v1/api_keys POST /v1/api_keys/{id}/rotate	this tenant already holds the maximum number of live API keys; revoke one first
archive_daily_cap	429	POST /v1/debts/{id}/defense-packet/archives	the daily archive cap for this debt is reached; retry after the interval in Retry-After
archive_unavailable	503	GET /v1/debts/{id}/defense-packet/archives/{aid}/attestation POST /v1/debts/{id}/defense-packet/archives	the archive store did not confirm the retention; nothing was archived
audit_unavailable	503	POST /v1/agent/preview/dial POST /v1/ai/conversations/{id}/takeover POST /v1/calls/{call_id}/conference/add … y 19 más	no evidence, no call: retry
bad_gateway	502	POST /v1/ai/agents/{id}/test POST /v1/messaging/brands POST /v1/messaging/brands/{id}/refresh … y 3 más	the AI runtime sandbox could not be reached
bad_request	400	DELETE /v1/debt-lists/{id}/members GET /v1/academy/progress GET /v1/academy/transcript … y 236 más	agent_id not accepted here: this scorecard is always the caller's own seat, derived from the token — use /v1/agents/occupancy or /v1/calls for another seat
call_control_failed	502	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/conference/remove POST /v1/calls/{call_id}/hangup … y 10 más	the switch rejected the control command
caller_id_unavailable	422	POST /v1/calls POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer … y 3 más	this call has no tenant caller-ID to present on a transferred leg
cannot_nest	409	POST /v1/subaccounts	—
capacity_unavailable	503	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer	the capacity gate could not admit the transferred leg, retry
captcha_failed	403	POST /v1/signups	the anti-bot check was not passed
captcha_unavailable	503	POST /v1/signups	the anti-bot check is unavailable; retry later
carrier_cps	429	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer	the carrier for the transferred leg is at its contracted call rate; retry
carrier_unavailable	503	POST /v1/port-requests	—
catalog_changed	422	POST /v1/reports/run	—
chunk_conflict	409	PUT /v1/screen-recordings/{id}/chunks/{n}	that chunk number already holds other bytes
client_address_not_measured	409	GET /v1/tenant/login-policy PUT /v1/tenant/login-policy	—
compliance_blocked	422	POST /v1/calls POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer … y 5 más	the compliance engine refused this call (tenant_policy)
conflict	409	DELETE /v1/ai/agents/{id} DELETE /v1/ai/agents/{id}/experiments/{experiment_id} DELETE /v1/campaigns/{id}/experiments/{experiment_id} … y 107 más	invalid state transition
consent_revoked	409	PUT /v1/consents/{phone}	the number revoked its consent at 2026-03-01T10:00:00Z; a new consent must carry a consented_at later than that
consent_version_mismatch	409	POST /v1/click-to-call/sites POST /v1/public/call-requests	—
cost_unreconciled	500	GET /v1/billing/cost	—
definition_conflict	422	POST /v1/reports/run	—
delivery_failed	502	POST /v1/phone_verification	the code could not be delivered
destination_not_found	422	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer POST /v1/calls/{call_id}/transfer/attended/cancel … y 2 más	no active agent with that destination in this tenant
destination_not_supported	422	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer POST /v1/calls/{call_id}/transfer/attended/cancel … y 2 más	an external transfer destination must be E.164 (+<country><number>)
destination_unavailable	422	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer POST /v1/calls/{call_id}/transfer/attended/cancel … y 2 más	that agent is not available to take a transfer right now
dial_error	502	POST /v1/agent/preview/dial POST /v1/calls POST /v1/campaigns/{id}/dial … y 1 más	the dialer could not place the call
did_unverified	422	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer POST /v1/calls/{call_id}/transfer/attended/cancel … y 2 más	the caller-ID this transferred leg would present is not a verified number of the tenant
disclosure_missing	422	POST /v1/calls	—
duplicate	200	PUT /v1/screen-recordings/{id}/chunks/{n}	—
duplicate_request	409	POST /v1/skip-trace/lookups	—
egress_unavailable	503	POST /v1/calls	—
esl_unavailable	503	POST /v1/ai/conversations/{id}/takeover POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/conference/remove … y 15 más	telephony control unavailable, retry
exceeds_parent_limit	422	PATCH /v1/subaccounts/{id} POST /v1/subaccounts	—
export_in_progress	429	POST /v1/recording-exports	an export is already running for this tenant; retry when it completes
export_too_large	422	POST /v1/recording-exports	the filters match 120000 recordings, above the 50000-row export limit; narrow the filters and retry
field_not_for_mode	422	POST /v1/reports/run	—
forbidden	403	DELETE /v1/ai/agents/{id}/experiments/{experiment_id} DELETE /v1/calls/{call_id}/stream DELETE /v1/click-to-call/sites/{id} … y 229 más	tenant is suspended
from_required	422	POST /v1/sms/messages	—
grant_already_live	409	POST /v1/support-access/grants	a support-access grant is already live for this tenant; revoke it before granting again
grant_already_revoked	409	DELETE /v1/support-access/grants/{id}	this grant was already revoked
import_in_progress	429	POST /v1/consents/import POST /v1/debt-lists/{id}/import POST /v1/debts/import	an import of this tenant is still running; retry when it finishes
invalid	400	POST /v1/campaigns POST /v1/planned-shifts PUT /v1/inbound-queues/{id}/callback-offer … y 1 más	—
invalid_assignee	422	POST /v1/sms/threads/{id}/assign	—
invalid_code	422	POST /v1/phone_verification/check	the code is wrong, expired or already used
invalid_contact_email	422	POST /v1/support/tickets	—
invalid_cursor	400	POST /v1/reports/run	—
invalid_definition_id	422	POST /v1/reports/run	—
invalid_phone	422	POST /v1/phone_verification	phone must be an E.164 number (+15551234567)
invalid_zone	422	POST /v1/screen-recordings/{id}/pii-marks	zone must be one of: consumer_card, full_number, payment, focus_lost
last_account_admin	409	DELETE /v1/users/{id}	the last active account_admin cannot be disabled; promote another one first
last_admin_seat	409	PATCH /v1/agents/{id}	—
mark_limit_reached	422	POST /v1/screen-recordings/{id}/pii-marks	—
mfa_required	403	POST /v1/auth/agent-login	this workspace requires a second factor for this sign-in
monitoring_ack_required	403	PATCH /v1/agents/{id}/status POST /v1/agents/checkin POST /v1/agents/{id}/resume	—
name_taken	409	POST /v1/report-definitions PUT /v1/report-definitions/{id}	a report definition with this name already exists for this tenant
no_account	422	POST /v1/dial/manual	no account of this tenant holds that number; no call was placed
no_ack	409	PUT /v1/screen-monitor/armed	acknowledge the current screen-monitor notice before arming
no_notice_published	409	POST /v1/agent-monitoring-acknowledgements POST /v1/screen-monitor/acks	—
no_rate	422	POST /v1/calls POST /v1/sms/messages	—
no_route	503	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer	no directed carrier route for the transferred leg; nothing was dialled
not_an_upgrade	422	POST /v1/billing/tier/upgrade	tier must cost strictly more than the current one; downgrades take effect at the next period and are not served here
not_armed	409	POST /v1/screen-monitor/sessions	the agent is not sharing their screen
not_checked_in	409	PUT /v1/screen-monitor/armed	—
not_configured	503	POST /v1/skip-trace/lookups	—
not_found	404	DELETE /v1/agents/{id}/credential DELETE /v1/ai/agents/{id} DELETE /v1/ai/agents/{id}/experiments/{experiment_id} … y 266 más	resource not found for this tenant
not_recording	409	POST /v1/calls/{call_id}/stream	the call has no live recording
number_in_use	409	POST /v1/port-requests	—
optout_instructions_missing	422	POST /v1/calls	—
password_blocklisted	422	POST /v1/auth/password-reset/confirm	password is on the list of commonly used or compromised passwords (reason: common)
payload_too_large	413	POST /v1/consents/import POST /v1/screen-monitor/sessions/{id}/signal POST /v1/suppressions/import	payload is over 16384 bytes
permission_denied	403	POST /v1/api_keys	—
permission_escalation	403	DELETE /v1/api_keys/{id} PATCH /v1/api_keys/{id} POST /v1/api_keys … y 1 más	—
phone_already_verified	409	POST /v1/phone_verification	the phone is already verified
phone_verification_rate_limited	429	POST /v1/phone_verification	too many verification codes requested; retry tomorrow
phone_verification_unavailable	503	POST /v1/phone_verification	phone verification is not available
plan_inactive	402	POST /v1/calls/{call_id}/transfer POST /v1/port-requests POST /v1/signups … y 3 más	tenant plan is not active; traffic is gated
port_in_busy	409	POST /v1/port-requests	—
port_in_unavailable	503	POST /v1/port-requests	—
port_request_limit	429	POST /v1/port-requests	—
presence_unavailable	503	POST /v1/agents/checkin	seat presence could not be recorded, retry
privacy_erasure_disabled	403	POST /v1/privacy/erasure-requests	—
prompt_render_failed	503	POST /v1/inbound-ivr-menus	a prompt could not be rendered to audio; the menu was not published
prompt_unavailable	503	POST /v1/calls	the message audio could not be rendered; no call was placed
provider_error	502	POST /v1/skip-trace/lookups POST /v1/sms/messages	the SMS provider rejected the message (:timeout)
qm_not_enabled	403	DELETE /v1/qm/forms/{id} PATCH /v1/qm/forms/{id} POST /v1/me/evaluations/{id}/dispute … y 2 más	QM is not enabled for this tenant
range_too_large	422	POST /v1/recording-exports	requested range exceeds the 366-day export limit
rate_limited	429	DELETE /v1/agents/{id}/credential DELETE /v1/ai/agents/{id} DELETE /v1/ai/agents/{id}/experiments/{experiment_id} … y 353 más	API key request quota exceeded; retry after the interval in Retry-After
recording_conflict	409	PUT /v1/screen-recordings/{id}/chunks/{n}	—
redaction_failed	409	POST /v1/screen-recordings/playback	—
redaction_pending	409	POST /v1/screen-recordings/playback	the redacted copy is not ready yet; the original is never served in its place
redaction_rejected	422	POST /v1/recordings/{id}/redaction	—
redactor_unavailable	503	POST /v1/recordings/{id}/redaction	—
registration_unverifiable	503	POST /v1/campaigns/{id}/dial	the agent's softphone registration could not be verified; no call was placed
render_rate_limited	429	POST /v1/calls	—
report_builder_disabled	503	POST /v1/reports/run	the report builder is not enabled for this tenant
report_timeout	503	POST /v1/reports/run	—
role_forbidden	403	DELETE /v1/agents/{id}/credential DELETE /v1/ai/agents/{id} DELETE /v1/ai/agents/{id}/experiments/{experiment_id} … y 103 más	watching a screen takes a supervisor or admin seat
sandbox_unavailable	503	POST /v1/ai/agents/{id}/test	the AI runtime sandbox is not configured or unreachable
sbc_error	502	POST /v1/carriers/{id}/provision POST /v1/carriers/{id}/revoke POST /v1/inbound-routes/{id}/provision	the SIP edge rejected the provisioning request
sbc_unavailable	503	POST /v1/agents/checkin POST /v1/widget_tokens/sip_credential	widget sip provisioning unavailable, retry
screen_recording_not_acknowledged	403	POST /v1/screen-recordings/{id}/pii-marks PUT /v1/screen-recordings/{id}/chunks/{n}	—
seat_limit_reached	422	PATCH /v1/agents/{id} POST /v1/agents	tier starter allows 5 active seats and the tenant already has them
seat_linked_to_user	409	PATCH /v1/agents/{id}	—
seat_mismatch	403	GET /v1/me POST /v1/agents/checkin POST /v1/agents/checkout	sip_extension does not match the seat this token owns
seat_not_linked	403	GET /v1/agent/queue GET /v1/me/evaluations GET /v1/me/scorecard … y 2 más	—
segment_out_of_range	422	POST /v1/recordings/{id}/redaction	—
self_evaluation_forbidden	403	POST /v1/qm/evaluations/{id}/dispute/resolution	—
session_closed	409	GET /v1/screen-monitor/sessions/{id}/ice POST /v1/screen-monitor/sessions/{id}/signal	that session is already closed
session_superseded	401	POST /v1/auth/login	—
signup_rate_limited	429	POST /v1/signups	too many sign-up requests; retry later
signup_unavailable	503	POST /v1/signups	—
skip_trace_cap_exceeded	429	POST /v1/skip-trace/lookups	—
sms_10dlc_campaign_required	422	POST /v1/sms/messages	—
sms_content_prohibited	422	POST /v1/sms/messages	—
sms_from_invalid	422	POST /v1/sms/messages	—
sms_from_not_owned	422	POST /v1/sms/messages	—
sms_optout_notice_missing	422	POST /v1/sms/messages	—
sms_provider_base_url_rejected	422	POST /v1/sms/messages	—
sms_provider_unconfigured	422	POST /v1/sms/messages	—
sms_spend_cap_exceeded	429	POST /v1/sms/messages	month-to-date SMS spend is at the tenant cap
sms_templates_only	422	PUT /v1/tenant/sms-auto-reply	—
stale_notice	409	POST /v1/agent-monitoring-acknowledgements POST /v1/screen-monitor/acks	that notice version is not the current one
stats_unavailable	503	GET /v1/stats/abandonment GET /v1/stats/penetration	the statistics could not be computed right now; retry shortly
storage_unavailable	503	POST /v1/recording-exports	recording export storage is not configured
stream_consent_required	422	POST /v1/calls/{call_id}/stream	the recording has no granted consent on file
stream_unavailable	503	POST /v1/calls/{call_id}/stream	call streaming is not available
subaccount_closed	409	PATCH /v1/subaccounts/{id}	—
subject_export_disabled	503	POST /v1/privacy/subject-exports	subject exports are not enabled for this tenant
supervision_capacity	429	POST /v1/supervision/calls/{call_id}/barge POST /v1/supervision/calls/{call_id}/listen POST /v1/supervision/calls/{call_id}/whisper	tenant supervision quota is full; retry when a supervised call ends
supervision_failed	502	POST /v1/ai/conversations/{id}/takeover POST /v1/supervision/calls/{call_id}/barge POST /v1/supervision/calls/{call_id}/listen … y 2 más	the switch rejected the supervision command
tenant_channels	429	POST /v1/calls/{call_id}/conference/add POST /v1/calls/{call_id}/transfer	the tenant is at its channel or call-rate ceiling; the third party was not dialled
terms_version_mismatch	422	POST /v1/signups	terms_version must be the current version (see GET /v1/signups/config)
test_environment	403	DELETE /v1/api_keys/{id} PATCH /v1/api_keys/{id} PATCH /v1/carriers/{id} … y 15 más	—
throttled	429	POST /v1/agent/preview/dial POST /v1/calls POST /v1/campaigns/{id}/dial … y 2 más	dial throttled (rate)
ticket_limit	409	POST /v1/support/tickets	—
tier_not_in_catalog	422	GET /v1/billing/tiers	—
too_many_connections	429	POST /v1/ws/ticket	live-floor connection limit reached for this tenant
too_many_groups	422	POST /v1/reports/run	—
too_many_marks	422	POST /v1/screen-recordings/{id}/pii-marks	—
transfer_targets_unavailable	503	GET /v1/transfer/targets	transfer targets could not be read, retry
trunk_endpoint_shared	409	POST /v1/carriers	sip_proxy is already the endpoint of another trunk and cannot be used for this one
turn_unavailable	503	GET /v1/screen-monitor/sessions/{id}/ice	this cell has no TURN relay configured for screen monitoring
unauthorized	401	DELETE /v1/agents/{id}/credential DELETE /v1/ai/agents/{id} DELETE /v1/ai/agents/{id}/experiments/{experiment_id} … y 451 más	invalid or revoked API key
unavailable	503	GET /v1/billing/cost POST /v1/ws/ticket	could not mint a websocket ticket
unknown_field	422	POST /v1/report-definitions POST /v1/reports/run	—
unknown_metric	422	POST /v1/reports/run	unknown metric(s): revenue; published: attempts, contacts
unknown_test_number	422	GET /v1/sandbox/records	—
unmask_without_pii_column	422	POST /v1/reports/run	—
unpriceable_tier	422	PATCH /v1/agents/{id} POST /v1/agents	the tenant's billing tier has no priced catalog row (tier_not_in_catalog)
unprocessable	422	DELETE /v1/consents/{phone} GET /v1/agents/handle-time GET /v1/billing/invoice … y 86 más	scheduled_at is closer than the minimum notice for a callback (10 minutes unless the tenant's callback_min_notice_seconds says otherwise)
unsupported_codec	422	POST /v1/recordings/{id}/redaction	—
unsupported_media_type	415	POST /v1/consents/import POST /v1/suppressions/import	this endpoint takes a text/csv body
verification_required	403	PATCH /v1/campaigns/{id} POST /v1/campaigns POST /v1/campaigns/{id}/resume … y 1 más	this account must be verified before it can create or start a campaign that runs without an agent
voice_preview_unavailable	503	POST /v1/ai/agents/{id}/voice-preview	the voice sample could not be produced right now
wallet_insufficient	402	POST /v1/calls POST /v1/calls/{call_id}/conference/add	prepaid balance is insufficient for this call
window_too_large	400	POST /v1/reports/run	the window may not exceed 31 days
would_lock_out_caller	422	PUT /v1/tenant/login-policy	—