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.

Error Code	Message
invalid_parameter	This list contains an invalid entry.
missing_required_parameter	A required parameter is missing from the request. Please refer to the technical reference for a complete list of parameters.
value_not_unique	This value must be unique.
boolean_required	This value must be a true or false boolean.
datetime_required	This value must be a DateTime.
http_url_required	This value must be an HTTP or HTTPS URL.
list_of_strings_required	This must be an array of strings only.
alphanumeric_required	This value must be alphanumeric.
incompatible_parameters	The parameters that were input cannot be specified together.
related_parameter_required	This parameter must be used in combination with its related parameter. See the reference for a complete list of available parameters.
not_available_for_assignment	This can not be assigned to the current target.
already_assigned	This has already been assigned.
invalid_for_type	This is not valid for the current type.
feature_not_available	This feature is not available to this account.
insufficient_balance	This account has an insufficient balance.
account_limit_exceeded	This account has reached its limit. It must be upgraded to perform this action.
rate_limit_exceeded	The rate limit has been exceeded.
invalid_number_format	The phone number is not in the correct format. Please use E.164 format, i.e., +15558675309.
number_not_supported	The phone number is not supported.
number_not_verified	'From' phone number not verified.
number_blacklisted	The phone number is blacklisted.
invalid_media_url	The media URL provided is invalid.
media_url_required	A media URL is required.
invalid_media_type	The media type provided is invalid.
media_size_exceeds_limit	The media size exceeds the allowed limit.
message_body_required	The message body is required.
invalid_message_body	The message body provided is invalid.
message_length_exceeds_limit	The message length exceeds the allowed limit.
invalid_destination_number	The destination phone number is invalid.
destination_number_not_supported	The destination phone number is not supported.
invalid_campaign_id	The campaign ID provided is invalid.
invalid_campaign_status	The campaign status is invalid.
campaign_limit_exceeded	The campaign limit has been exceeded.
campaign_not_found	The campaign ID provided could not be found.
invalid_auth_token_permissions	Permissions list contains invalid selections. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video.
invalid_subproject_id	The subproject ID passed could not be found or does not belong to the project being used to authenticate the request.
already_verified	This number is already verified.
unsupported_region	This number must be from an allowed region.
purchased_too_recently	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.
does_not_exist	This entry does not exist.
unsupported_mode	This mode is not supported on this number.
invalid_state	The object is not in the correct state for this action.
not_a_valid_json	This value must be valid JSON.
upload_error	There was an error while uploading the file. Please try again.
file_size_limit_exceeded	The file size is too big.
no_channel_specified	You must specify a channel.
cannot_remove_assignment_from_integration_test	You cannot remove the assignment from an integration test campaign.
auto_top_up_deactivated	Auto top-up is not active on this account.
invalid_object	This object is invalid. Refer to the error message for more details.
exceeds_platform_stream_limit	Adding an additional stream would exceed the allowed number of streams per room.
must_belong_to_project	The requested resource must belong to the project being used to authenticate the request.
no_installed_applications	Fabric Application must be installed in this project.
sort_order_validations	Sort order cannot be specified without sort by.
missing_fabric_application	Signalwire Access Token must be associated with a Fabric Application to perform this action
list_of_hashes_required	This value must be an array of hashes
conversation_flow_steps_are_invalid	This value must be an array. Example: ["Intro", ["Introduce yourself", "Ask caller's name"], "Summarize the conversation and thank the caller"]
duplicate_skill_type	Only one skill of this type can exist per AI Agent.
invalid_zendesk_capability	The Zendesk Capability is invalid.
invalid_addresses_for_transfer_skill	Addresses must contain non-empty values for name and destination
document_version_mismatch	The document_version does not match the current record's document_version.
resource_assigned_as_handler	You cannot delete a resource if it is currently assigned as a call or message handler
invalid_resource_type	The passed resource type is not a valid resource type
malformed_xml	The XML is not well formed
invalid_mustache_syntax	The mustache syntax is invalid..
token_invalid_or_unadoptable	The provided FreeSWITCH token is incorrect or not ready for adoption
unique_within_project	Value must be unique within project
string_required	Value must be formatted as a string
json_or_yaml_required	Value must be a valid JSON or YAML document
terms_and_conditions_required	You must agree to the terms and conditions to complete registration.
incorrect_keyword_format	Keywords must be comma separated values with no space.
incorrect_number_of_sub_use_cases	Mixed use case campaigns require minimum 2 and maximum 5 sub use cases.
invalid_sub_use_cases	This sub use case is not valid.
missing_sub_use_cases	Sub use cases are required for MIXED and LOW_VOLUME_MIXED campaigns.
sub_use_cases_present	Sub use cases are not permitted for non mixed campaign use case.
number_assignment_cannot_be_removed	Number assignments can only be removed if they are active, failed, or assigned to a pending campaign.
invalid_list_items	The list items are invalid.
campaign_inactive	Numbers cannot be assigned to an inactive campaign
number_of_assignments_exceed_limit	The requested assignment would exceed the allowed number of assigned numbers for the selected campaign.
invalid_chunking_params_for_sentence_chunking	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	Provided chunking parameters are not valid for sliding chunking. Allowed parameters are chunk_size and overlap_size.
invalid_chunking_params_for_page_chunking	Chunking parameters are not allowed for page chunking.
invalid_chunking_params_for_paragraph_chunking	Chunking parameters are not allowed for paragraph chunking.
query_processing_failed	The query cannot be processed at the moment. Please try again later.
address_limit_exceeded	The number of allowed addresses has been exceeded.
max_queued_messages_exceeded	has exceeded the maximum number of queued messages/calls for this number
not_purchased_or_verified	The phone number must be purchased or verified.
not_registered	The endpoint is not registered.
not_voice_capable	The number must be voice capable.
not_valid_for_caller_id	The value is not valid (must be an E.164 number, caller ID string or SIP URI)
cannot_cancel_in_progress	In progress calls can not be updated.
cannot_update_completed	Completed calls cannot be updated.
cannot_redirect_not_in_progress	Call is not in-progress. Cannot redirect.
cannot_process	The request cannot be processed at the moment. Please try again later.
not_e164	The number must be in E.164 format.
no_devices_or_registrations	The fabric address has no registered devices or current online registrations.
no_registered_devices	The fabric address has no registered devices.
exceeds_history_logs_limit	This value exceeds the allowed date limit.
page_token_required	A page token is required if the page_number value is greater than 0.
invalid_http_method	This request method must be GET or POST.
brand_not_unique	The CSP Brand Reference must be unique within the space