Error Codes

When using SignalWire REST APIs, some errors will include error codes. Below, you will find a list of our unique error codes and a short explanation of each to help with error handling and troubleshooting.

account_limit_exceeded

Error

• This account has reached its limit. It must be upgraded to perform this action.

address_limit_exceeded

Error

• The number of allowed addresses has been exceeded.

already_assigned

Error

• This has already been assigned.

already_verified

Error

• This number is already verified.

alphanumeric_required

Error

• This value must be alphanumeric.

auto_top_up_deactivated

Error

• Auto top-up is not active on this account.

boolean_required

Error

• This value must be a true or false boolean.

brand_not_unique

Error

• The CSP Brand Reference must be unique within the space

campaign_inactive

Error

• Numbers cannot be assigned to an inactive campaign

campaign_limit_exceeded

Error

• The campaign limit has been exceeded.

campaign_not_found

Error

• The campaign ID provided could not be found.

cannot_cancel_in_progress

Error

• In progress calls can not be updated.

cannot_process

Error

• The request cannot be processed at the moment. Please try again later.

cannot_redirect_not_in_progress

Error

• Call is not in-progress. Cannot redirect.

cannot_remove_assignment_from_integration_test

Error

• You cannot remove the assignment from an integration test campaign.

cannot_update_completed

Error

• Completed calls cannot be updated.

conversation_flow_steps_are_invalid

Error

• This value must be an array. Example: ["Intro", ["Introduce yourself", "Ask caller's name"], "Summarize the conversation and thank the caller"]

datetime_required

Error

• This value must be a DateTime.

destination_number_not_supported

Error

• The destination phone number is not supported.

document_version_mismatch

Error

• The document_version does not match the current record's document_version.

does_not_exist

Error

• This entry does not exist.

duplicate_skill_type

Error

• Only one skill of this type can exist per AI Agent.

exceeds_history_logs_limit

Error

• This value exceeds the allowed date limit.

exceeds_platform_stream_limit

Error

• Adding an additional stream would exceed the allowed number of streams per room.

feature_not_available

Error

• This feature is not available to this account.

file_size_limit_exceeded

Error

• The file size is too big.

http_url_required

Error

• This value must be an HTTP or HTTPS URL.

incompatible_parameters

Error

• The parameters that were input cannot be specified together.

incorrect_keyword_format

Error

• Keywords must be comma separated values with no space.

incorrect_number_of_sub_use_cases

Error

• Mixed use case campaigns require minimum 2 and maximum 5 sub use cases.

insufficient_balance

Error

• This account has an insufficient balance.

invalid_addresses_for_transfer_skill

Error

• Addresses must contain non-empty values for name and destination

invalid_auth_token_permissions

Error

• Permissions list contains invalid selections. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video.

invalid_campaign_id

Error

• The campaign ID provided is invalid.

invalid_campaign_status

Error

• The campaign status is invalid.

invalid_chunking_params_for_page_chunking

Error

• Chunking parameters are not allowed for page chunking.

invalid_chunking_params_for_paragraph_chunking

Error

• Chunking parameters are not allowed for paragraph chunking.

invalid_chunking_params_for_sentence_chunking

Error

• Provided chunking parameters are not valid for sentence chunking. Allowed parameters are max_sentences_per_chunk and split_newlines.

invalid_chunking_params_for_sliding_chunking

Error

• Provided chunking parameters are not valid for sliding chunking. Allowed parameters are chunk_size and overlap_size.

invalid_destination_number

Error

• The destination phone number is invalid.

invalid_for_type

Error

• This is not valid for the current type.

invalid_http_method

Error

• This request method must be GET or POST.

invalid_list_items

Error

• The list items are invalid.

invalid_media_type

Error

• The media type provided is invalid.

invalid_media_url

Error

• The media URL provided is invalid.

invalid_message_body

Error

• The message body provided is invalid.

invalid_mustache_syntax

Error

• The mustache syntax is invalid..

invalid_number_format

Error

• The phone number is not in the correct format. Please use E.164 format, i.e., +15558675309.

invalid_object

Error

• This object is invalid. Refer to the error message for more details.

invalid_parameter

Error

• This list contains an invalid entry.

invalid_resource_type

Error

• The passed resource type is not a valid resource type

invalid_state

Error

• The object is not in the correct state for this action.

invalid_sub_use_cases

Error

• This sub use case is not valid.

invalid_subproject_id

Error

• The subproject ID passed could not be found or does not belong to the project being used to authenticate the request.

invalid_zendesk_capability

Error

• The Zendesk Capability is invalid.

json_or_yaml_required

Error

• Value must be a valid JSON or YAML document

list_of_hashes_required

Error

• This value must be an array of hashes

list_of_strings_required

Error

• This must be an array of strings only.

malformed_xml

Error

• The XML is not well formed

max_queued_messages_exceeded

Error

• has exceeded the maximum number of queued messages/calls for this number

media_size_exceeds_limit

Error

• The media size exceeds the allowed limit.

media_url_required

Error

• A media URL is required.

message_body_required

Error

• The message body is required.

message_length_exceeds_limit

Error

• The message length exceeds the allowed limit.

missing_fabric_application

Error

• Signalwire Access Token must be associated with a Fabric Application to perform this action

missing_required_parameter

Error

• A required parameter is missing from the request. Please refer to the technical reference for a complete list of parameters.

missing_sub_use_cases

Error

• Sub use cases are required for MIXED and LOW_VOLUME_MIXED campaigns.

must_belong_to_project

Error

• The requested resource must belong to the project being used to authenticate the request.

no_channel_specified

Error

• You must specify a channel.

no_devices_or_registrations

Error

• The fabric address has no registered devices or current online registrations.

no_installed_applications

Error

• Fabric Application must be installed in this project.

no_registered_devices

Error

• The fabric address has no registered devices.

not_a_valid_json

Error

• This value must be valid JSON.

not_available_for_assignment

Error

• This can not be assigned to the current target.

not_e164

Error

• The number must be in E.164 format.

not_purchased_or_verified

Error

• The phone number must be purchased or verified.

not_registered

Error

• The endpoint is not registered.

not_routable

Error

• The call is not routable.

not_valid_for_caller_id

Error

• The value is not valid (must be an E.164 number, caller ID string or SIP URI)

not_voice_capable

Error

• The number must be voice capable.

number_assignment_cannot_be_removed

Error

• Number assignments can only be removed if they are active, failed, or assigned to a pending campaign.

number_blacklisted

Error

• The phone number is blacklisted.

number_not_supported

Error

• The phone number is not supported.

number_not_verified

Error

• 'From' phone number not verified.

number_of_assignments_exceed_limit

Error

• The requested assignment would exceed the allowed number of assigned numbers for the selected campaign.

page_token_required

Error

• A page token is required if the page_number value is greater than 0.

purchased_too_recently

Error

• This number was purchased too recently to release. Please wait 14 days after purchase to release this number or 30 days if your account is in trial mode. Contact Support for further assistance.

query_processing_failed

Error

• The query cannot be processed at the moment. Please try again later.

rate_limit_exceeded

Error

• The rate limit has been exceeded.

related_parameter_required

Error

• This parameter must be used in combination with its related parameter. See the reference for a complete list of available parameters.

resource_assigned_as_handler

Error

• You cannot delete a resource if it is currently assigned as a call or message handler

sort_order_validations

Error

• Sort order cannot be specified without sort by.

string_required

Error

• Value must be formatted as a string

sub_use_cases_present

Error

• Sub use cases are not permitted for non mixed campaign use case.

terms_and_conditions_required

Error

• You must agree to the terms and conditions to complete registration.

token_invalid_or_unadoptable

Error

• The provided FreeSWITCH token is incorrect or not ready for adoption

unique_within_project

Error

• Value must be unique within project

unsupported_mode

Error

• This mode is not supported on this number.

unsupported_region

Error

• This number must be from an allowed region.

upload_error

Error

• There was an error while uploading the file. Please try again.

value_not_unique

Error

• This value must be unique.