← API Reference
Reference

Error reference

Failures return request_id and an error object with legacy code, five-digit numeric_code, and message. Branch on code or numeric_code, never message; numeric_code can refine Provider causes without changing the original HTTP status or legacy code.

400 Bad Request

  • invalid_request10000

    Request body cannot be decoded or required fields are missing.

  • invalid_provider30000

    Provider name in the URL is missing or unsupported.

  • unsupported_action30005

    Account action is not recognised.

  • invalid_conversation_type37000

    type must be user, group, or channel.

  • unsupported_conversation_type37001

    Provider does not support that operation for this conversation type.

  • unsupported_message_type36000

    message.type is not supported by the selected provider.

  • unsupported_provider_auth_mode20018

    auth_mode is not supported by the selected provider.

  • auth_mode_phone_required20019

    The selected auth mode requires provider_data.phone at account creation.

  • invalid_reply_token36006

    reply_to.reply_token is tampered with, encrypted with a different key, or otherwise unreadable. Pass the token from data.message.reply_token back unchanged.

  • provider_invalid_request30001

    The provider adapter rejected provider-specific request data as invalid.

  • create_api_key_failed11101

    API key creation request was rejected.

  • update_api_key_failed11102

    API key update request was rejected.

  • rotate_api_key_failed11103

    API key rotation request was rejected.

  • update_workspace_failed41001

    Workspace update was rejected.

401 Unauthorized

  • missing_api_key11000

    The X-Api-Key request header is missing.

  • invalid_api_key11001

    The API key is not recognised or has been disabled.

403 Forbidden

  • cors_forbidden11009

    The CORS preflight origin, method, or requested headers are not allowed.

404 Not Found

  • not_found10001

    The route does not exist.

  • conversation_not_found37002

    The conversation could not be found by the provider.

  • contact_not_found35000

    The contact could not be found under this account.

  • group_not_found34004

    The group could not be found under this account.

409 Conflict

  • account_allocation_busy20011

    Account allocation lock is held; retry after a short delay.

  • no_allocatable_server20013

    No allocatable provider server in the requested region.

  • workspace_account_quota_exceeded20014

    The workspace account quota has been exhausted.

  • duplicate_provider_account20015

    Another account in this workspace already uses the same provider identity.

  • account_already_authorized20016

    The account is already authorised; the requested auth action is rejected.

  • account_binding_not_found30006

    The account is not bound to an active provider server.

  • provider_account_mismatch20017

    The requested provider identity does not match the account binding.

  • provider_not_ready30009

    The provider runtime is not ready for this operation yet.

422 Unprocessable Entity

  • contact_not_found35000

    GET /contacts/info returns Conversation not found when the target conversation does not exist.

500 Internal Server Error

  • create_account_failed20002

    Server-side error while creating the account.

  • update_account_failed20003

    Server-side error while updating the account.

  • delete_account_failed20004

    Server-side error while deleting the account.

  • get_account_failed20001

    Server-side error while loading account details.

  • list_accounts_failed20000

    Server-side error while listing accounts.

  • get_session_failed20005

    Server-side error while loading the authentication session.

  • get_auth_state_failed20006

    Server-side error while loading authentication state.

  • run_action_failed20007

    Server-side error while running an account action.

  • run_runtime_action_failed20008

    Server-side error while running a runtime action.

  • run_session_action_failed20009

    Server-side error while running a session action.

  • run_auth_action_failed20010

    Server-side error while running an authentication action.

  • send_message_failed36001

    Server-side error while sending the message.

  • pin_message_failed36002

    Server-side or upstream error while pinning / unpinning the message.

  • revoke_message_failed36003

    Server-side or upstream error while revoking the message.

  • react_message_failed36004

    Server-side or upstream error while reacting to the message.

  • edit_message_failed36005

    Server-side or upstream error while editing the message text.

  • list_conversations_failed37003

    Server-side error while listing conversations.

  • get_conversation_failed37004

    Server-side error while loading the conversation.

  • list_conversation_members_failed37005

    Server-side error while listing conversation members.

  • mark_conversation_read_failed37006

    Server-side or upstream error while marking the conversation as read.

  • mark_conversation_unread_failed37007

    Server-side or upstream error while marking the conversation as unread.

  • mute_conversation_failed37008

    Server-side or upstream error while muting the conversation.

  • unmute_conversation_failed37009

    Server-side or upstream error while unmuting the conversation.

  • pin_conversation_failed37010

    Server-side or upstream error while pinning the conversation.

  • unpin_conversation_failed37011

    Server-side or upstream error while unpinning the conversation.

  • list_conversation_labels_failed37012

    Server-side or upstream error while listing conversation labels.

  • upsert_label_failed37013

    Server-side or upstream error while creating or updating a label.

  • delete_label_failed37014

    Server-side or upstream error while deleting a label.

  • set_label_members_failed37015

    Server-side or upstream error while tagging or untagging conversations.

  • list_contacts_failed35001

    Server-side error while listing contacts.

  • get_contact_failed35002

    Server-side error while loading the contact.

  • create_contact_failed35003

    Server-side or channel error while adding the contact.

  • get_contact_membership_failed35004

    Server-side or channel error while checking contact membership.

  • block_contact_failed35005

    Server-side or upstream error while blocking the contact.

  • unblock_contact_failed35006

    Server-side or upstream error while unblocking the contact.

  • list_blocklist_failed35007

    Server-side or upstream error while loading the blocklist.

  • set_contact_note_failed35008

    Server-side or upstream error while setting or clearing the contact note.

  • list_groups_failed34000

    Server-side error while listing groups.

  • get_group_failed34001

    Server-side error while loading the group.

  • create_group_failed34002

    Server-side or upstream error while creating the group.

  • leave_group_failed34003

    Server-side or upstream error while leaving the group.

  • update_group_members_failed34005

    Server-side or upstream error while updating group members.

  • update_group_info_failed34006

    Server-side or upstream error while updating the group name, description, or avatar (including admin-permission rejections).

  • list_group_join_requests_failed34007

    Server-side or upstream error while listing pending group join requests.

  • update_group_join_requests_failed34008

    Server-side or upstream error while approving / rejecting group join requests.

  • set_group_join_approval_mode_failed34009

    Server-side or upstream error while toggling the group join approval mode.

  • get_group_invite_code_failed34010

    Server-side or upstream error while fetching the group invite link / code.

  • list_webhook_endpoints_failed40000

    Server-side error while listing webhook endpoints.

  • create_webhook_endpoint_failed40001

    Server-side error while creating the webhook endpoint.

  • get_webhook_endpoint_failed40002

    Server-side error while loading the webhook endpoint.

  • update_webhook_endpoint_failed40003

    Server-side error while updating the webhook endpoint.

  • deactivate_webhook_endpoint_failed40004

    Server-side error while deactivating the webhook endpoint.

  • delete_webhook_endpoint_failed40005

    Server-side error while deleting the webhook endpoint.

  • get_workspace_failed41000

    Server-side error while loading the workspace.

  • list_api_keys_failed11100

    Server-side error while listing API keys.

  • list_provider_regions_failed30011

    Server-side error while listing provider regions.

501 Not Implemented

  • unsupported_by_provider30003

    The selected provider has not implemented this endpoint.

502 Bad Gateway

  • provider_adapter_not_found30004

    The provider adapter is unavailable or not registered.

  • provider_unavailable30002

    The provider or its upstream service is temporarily unavailable.

503 Service Unavailable

  • allocation_service_unavailable20012

    The allocation lock service is unavailable; retry shortly.

Provider detail numeric codes

These codes refine a Provider cause without changing the original HTTP status or legacy code.

  • provider_operation_failed30010

    Provider operation failed

    Generic provider operation failure.

  • group_not_found34004

    Group not found

    The group cannot be found; legacy provider paths may retain their original HTTP status and code.

  • group_not_participant34011

    Account is not participating in this group

    The group may exist, but the current account is not a participant.