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
- The account must be upgraded to perform this action.
allowed_address_limit_exceeded
- The maximum number of allowed addresses has been exceeded.
already_assigned
- This resource is already assigned.
already_verified
- This number is already verified.
address_has_no_valid_channels
- The address has no valid channels.
auto_top_up_deactivated
- Auto top-up is not active on this account.
authblock_is_invalid
- The authblock is invalid or doesn’t reference an existing subscriber.
authblock_is_expired
- The expires_at timestamp of the subscriber from the authblock has passed.
billing_route_not_found
- Unable to locate a billing route.
brand_not_unique
- The CSP Brand Reference must be unique within the Space
call_id_is_duplicated
- The provided call ID is already associated with an existing call.
call_update_failed
- The call update could not be completed at this time. Please try again, and contact support if issues persist.
campaign_inactive
- Numbers cannot be assigned to an inactive campaign
campaign_limit_exceeded
- The campaign limit has been exceeded.
campaign_not_active
- Campaign must be active.
campaign_not_found
- The campaign ID provided could not be found.
cannot_cancel_in_progress
- Cannot cancel an in-progress call.
cannot_process
- The request cannot be processed right now.
cannot_redirect_not_in_progress
- Call is not in-progress. Cannot redirect.
cannot_remove_assignment_from_integration_test
- You cannot remove the assignment from an integration test campaign.
cannot_update_completed
- Completed calls cannot be updated.
channel_has_missing_properties
- Channel must have read or write property.
channel_name_is_reserved
- The channel name uses a reserved prefix.
channel_name_size_limit_exceeded
- The channel name exceeds the maximum allowed length.
channel_size_limit_exceeded
- The number of channels exceeds the allowed limit.
chat_token_invalid_for_session
- The provided token is invalid for the provided room session.
chat_token_is_invalid
- The provided token is not a valid chat token.
contains_external_entities
- XML contains external entity definitions which are not allowed for security reasons.
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”]
could_not_purchase
- The resource could not be purchased.
destination_number_not_supported
- The destination phone number is not supported.
document_version_mismatch
- The document_version does not match the current record’s document_version.
does_not_exist
- This entry does not exist.
domain_has_no_password
- The domain has not been configured with a password.
duplicate_skill_type
- Only one skill of this type can exist per AI Agent.
exceeds_history_logs_limit
- This value exceeds the allowed date limit.
exceeds_platform_stream_limit
- Adding an additional stream would exceed the allowed number of streams per room.
feature_not_available
- This feature is not available to this account.
file_already_exists
- An asset already exists with this project, path, and filename.
file_can_not_be_opened
- An error occurred trying to open the provided file.
file_exceeds_size_limit
- The file exceeds the maximum allowed size.
file_not_found
- The requested file could not be found (404 Not Found). Please check the URL and try again.
from_fabric_address_id_does_not_match_subscriber
- The provided from_fabric_address_id does not match an address for the provided subscriber.
incompatible_parameters
- The parameters that were input cannot be specified together.
incorrect_keyword_format
- Keywords must be comma separated values with no space.
incorrect_number_of_sub_use_cases_low_volume
- Mixed use case campaigns require minimum 2 and maximum 5 sub use cases.
incorrect_number_of_sub_use_cases_mixed
- Mixed use case campaigns require minimum 2 and maximum 5 sub use cases.
inline_swml_or_swml_webhook_required
- You must pass instructions through inline SWML or a URL to a SWML document.
insufficient_balance
- This account has an insufficient balance.
invalid_addresses_for_transfer_skill
- Addresses must contain non-empty values for name and destination
invalid_auth_token_permissions
- Permissions list contains invalid selections. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video.
invalid_call_handler_for_external_swml_handler
- Handler must be calling or messaging.
invalid_call_handler_for_swml_application
- Handler must be external_url or script.
invalid_call_id_passed
- The call ID must not point to a cXML call.
invalid_campaign_id
- The campaign ID provided is invalid.
invalid_campaign_status
- The campaign status is invalid.
invalid_command_attempted
- The specified command is invalid.
invalid_content_type
- Invalid content type.
invalid_destination_number
- The destination phone number is invalid.
invalid_for_type
- This is not valid for the current type.
invalid_for_page_chunking
- Chunking parameters are not allowed for page chunking.
invalid_for_paragraph_chunking
- Chunking parameters are not allowed for paragraph chunking.
invalid_for_sentence_chunking
- Provided chunking parameters are not valid for sentence chunking. Allowed parameters are max_sentences_per_chunk and split_newlines.
invalid_for_sliding_chunking
- Provided chunking parameters are not valid for sliding chunking. Allowed parameters are chunk_size and overlap_size.
invalid_group_configuration
- Fabric addresses must form a valid conversation group (a single room or two non-room subscribers) and group ID must start with ‘sw_’.
invalid_handler_use
- Handler must be calling or messaging.
invalid_http_method
- This request method must be GET or POST.
invalid_join_until_date
- Join Until date can’t be in the past of Join From date.
invalid_list_items
- The list items are invalid.
invalid_media_type
- The media type provided is invalid.
invalid_media_url
- The media URL provided is invalid.
invalid_message_body
- The message body provided is invalid.
invalid_mustache_syntax
- The mustache syntax is invalid..
invalid_number_format
- The phone number is not in the correct format. Please use E.164 format, i.e., +15558675309.
invalid_object
- This object is invalid. Refer to the error message for more details.
invalid_parameter
- This list contains an invalid entry.
invalid_pstn_destination
- The PSTN destination is either missing or not in E164 format.
invalid_relay_connector_parameters
- Send relay_connector_id to link to an existing connector or relay_connector_name and relay_connector_token to create a new one.
invalid_resource_for_handler
- This resource is not valid for the specified handler type.
invalid_resource_type
- The passed resource type is not a valid resource type.
invalid_room_session
- The room session ID does not point to a valid room session.
invalid_sip_configuration
- The SIP configuration value is invalid.
invalid_sip_destination
- The SIP destination is either missing or could not be parsed.
invalid_state
- The object is not in the correct state for this action.
invalid_sub_use_cases
- This sub use case is not valid.
invalid_subproject_id
- The subproject ID passed could not be found or does not belong to the project being used to authenticate the request.
invalid_token_format
- The format of the provided token is invalid.
invalid_zendesk_capability
- The Zendesk Capability is invalid.
list_contains_invalid_entries
- The list contains an invalid entry.
malformed_xml
- The XML is not well formed
max_queued_calls_exceeded
- The maximum number of queued calls has been exceeded.
max_queued_messages_exceeded
- has exceeded the maximum number of queued messages/calls for this number
media_size_exceeds_limit
- The media size exceeds the allowed limit.
media_url_required
- A media URL is required.
message_body_required
- The message body is required.
message_length_exceeds_limit
- The message length exceeds the allowed limit.
messaging_provider_invalid
- Messaging provider is invalid.
missing_required_parameter
- The passed value is blank or empty, but it is required.
missing_sub_use_cases
- Sub use cases are required for MIXED and LOW_VOLUME_MIXED campaigns.
missing_sip_configuration
- The SIP configuration requires at least one selection.
must_belong_to_project
- The requested resource must belong to the project being used to authenticate the request.
must_specify_related_parameter
- This parameter must be used in combination with a related parameter.
no_channel_specified
- You must specify a channel.
no_devices_or_registrations
- The fabric address has no registered devices or current online registrations.
no_fabric_addresses
- The resource has no fabric addresses.
no_installed_applications
- Fabric Application must be installed in this project.
no_registered_devices
- The fabric address has no registered devices.
no_steered_resource
- The project has a steering tag set, but no steered resource is available for that tag.
no_valid_number_for_random_send_as_selection
- There is no purchased or verified number in the project to select as the send_as.
not_a_boolean
- Value must be true or false.
not_a_datetime
- Value must be a datetime.
not_a_hash
- Value must be a valid hash.
not_a_refresh_token
- Invalid token type. You must use a Refresh token.
not_a_string
- Value must be formatted as a string.
not_a_valid_json
- This value must be valid JSON.
not_allowed_on_subscription_plan
- This feature is not allowed on your current subscription plan.
not_alphanumeric
- Value must be alphanumeric.
not_an_array_of_hashes
- Value must be an array of hashes.
not_an_array_of_strings
- Value must be an array of strings.
not_an_http_url
- Value must be an HTTP or HTTPS URL.
not_available_for_assignment
- This can not be assigned to the current target.
not_e164
- The number must be in E.164 format.
not_json_or_yaml
- Value must be a valid JSON or YAML document.
not_parsable
- Value is not parsable.
not_parseable
- Value is not parseable.
not_purchased_or_verified
- The phone number must be purchased or verified.
not_registered
- The endpoint is not registered.
not_routable
- Unable to locate a route to the destination number. Please check geographic permissions and the destination number, and contact Support if issues persist.
not_valid_for_caller_id
- The value is not valid (must be an E.164 number, caller ID string or SIP URI)
not_voice_capable
- The number must be voice capable.
not_unique_within_project
- Value must be unique within project.
not_unique_within_space
- Value must be unique within space.
number_assignment_cannot_be_removed
- Number assignments can only be removed if they are active, failed, or assigned to a pending campaign.
number_blacklisted
- The phone number is blacklisted.
number_not_supported
- The phone number is not supported.
number_not_verified
- ‘From’ phone number not verified.
number_of_assignments_exceed_limit
- The requested assignment would exceed the allowed number of assigned numbers for the selected campaign.
out_of_sync
- The resource is out of sync.
page_token_is_invalid
- The provided page token is not valid.
page_token_required
- A page token is required if the page_number value is greater than 0.
page_token_required_for_next_page
- The page token is required when the page number is passed and greater than 0.
provided_id_is_unrecognized
- The provided ID is unrecognized. Verify that the ID points to a valid resource belonging to the current project.
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.
query_processing_failed
- The query cannot be processed at the moment. Please try again later.
rate_limit_exceeded
- The rate limit has been exceeded.
resource_assigned_as_handler
- You cannot delete a resource if it is currently assigned as a call or message handler
resource_in_different_project
- The fabric resource is in a different project.
resource_not_allowed
- Calls to this fabric resource are not allowed with this authorization.
resource_not_callable
- The fabric resource is not callable.
resource_not_deletable
- Resource cannot be deleted.
room_is_not_chat_enabled
- The room for the provided room session does not have chat enabled.
room_token_invalid_for_session
- The provided token is invalid for the provided room session.
room_token_is_invalid
- The provided token is not a valid room token.
sat_must_have_application
- SignalWire Access Token must be associated with a Fabric Application to perform this action.
send_as_is_invalid
- The provided send_as number is missing or invalid.
sip_gateway_uri_must_be_external
- Only external SIP entities are supported for the SIP Gateway. Do not provide a SignalWire-managed SIP entity.
sort_order_validations
- Sort order cannot be specified without sort by.
state_size_limit_exceeded
- The state size exceeds the maximum allowed limit.
sub_use_cases_present
- Sub use cases are not permitted for non mixed campaign use case.
terms_and_conditions_required
- You must agree to the terms and conditions to complete registration.
to_destination_unresolvable
- The destination does not resolve to a valid destination.
token_expired
- Token has expired.
token_has_invalid_prefix
- The token includes an invalid format prefix.
token_invalid
- The provided token is invalid.
token_invalid_or_unadoptable
- The provided FreeSWITCH token is incorrect or not ready for adoption
token_not_associated_with_video_room
- The provided token is not associated with a valid video room.
too_many_verification_attempts
- Too many incorrect attempts to verify this number.
too_many_verification_requests
- Too many call requests without verifying this number.
too_many_verification_requests_in_time_frame
- This account has had too many Verified Caller ID requests within a short timeframe. As a precaution, we have disabled creating more for a short time. Please contact support if you need this restriction lifted sooner.
unknown_download_error
- An unexpected error occurred while downloading the file. Please try again later or contact support if the issue persists.
unrecognized_fabric_addresses
- One or more of the provided fabric addresses is unrecognized. Check that all IDs are valid and belong to the current project.
unsupported_file_extension
- Unsupported file extension.
unsupported_mode
- This mode is not supported on this number.
unsupported_option
- The specified option is not supported.
unsupported_region
- This number must be from an allowed region.
uri_does_not_resolve_to_address
- The provided URI does not resolve to a recognized address.
uri_does_not_resolve_to_resource
- The provided URI does not resolve to a valid resource.
uri_resolves_to_unsupported_resource
- The provided URI resolves to a resource that is unsupported for dialing.
upload_error
- There was an error while uploading the file. Please try again.
url_failed_to_parse
- An unknown error occurred when parsing the provided URL.
url_is_unsafe
- URL must not point to internal/private networks.
value_not_unique
- This value must be unique.
verification_request_too_soon
- This number has received a verification call too recently. Please wait a minute before requesting another call.
