Dispatch

All Sections

API Error Codes

Content

Error response format

An error will bla bla....

HTTP/1.1 400 Bad Request
Content-Type: application/json
...
 
{
  errors: [
    {
      "code": "InvalidParameter",
      "message": "The value 'tomorrow' for property 'deliveryTime' is not a valid ISO 8601 DateTime"
    },
    {
      "code": "MissingParameter",
      "message": "The required property 'targetId' was not present in the request body"
    }
  ]
}

Common Errors

HTTP Status Code	Error Code	Description	Retryable?
500	-	Internal Server Error	Yes*
400	`InvalidParameter`	A supplied parameter did not match an expected value or format	No
400	`MissingParameter`	A required parameter was not present in the request	No
401	`MissingAccessToken`	No access token was provided in the request	No
401	`InvalidAccessToken`	The access token could not be verified	No
401	`ExpiredAccessToken`	The provided access token has expired	No
401	`MissingPermission`	The provided access token is missing a required permission in its scope	No

* Depending on the nature of the underlying error the problem may or may not be resolved by retrying. We advice only performing a small amount of retries in case the error is more permanent.

Specific Errors

HTTP Status Code	Error Code	Description	Retryable?
400	`E-DI-3001`	Target not found	No
400	`E-DI-3002`	Unknown target type	No
400	`E-DI-3003`	Cannot enable an already enabled target	No
400	`E-DI-3004`	Cannot disable an already disabled target	No
400	`E-DI-3010`	Unknown error	Maybe*
400	`E-DI-3011`	The endpoint domain has not been verified	No
400	`E-DI-3020`	Unknown error	Maybe*
400	`E-DI-3021`	Insufficient role permissions	No
400	`E-DI-3022`	The target queue does not exist	No
400	`E-DI-3023`	Unable to assume the configured role	No
400	`E-DI-3030`	Unknown error	Maybe*
400	`E-DI-3031`	Insufficient role permissions	No
400	`E-DI-3032`	The target topic does not exist	No
400	`E-DI-3033`	Unable to assume the configured role	No
400	`E-DI-3034`	Unable to parse AWS region from Topic ARN	No
400	`E-DI-4001`	Domain not found	No
400	`E-DI-4002`	Domain name already in use	No
400	`E-DI-4003`	Domain has already been verified	No
400	`E-DI-4004`	Domain has been marked as deleted	No
400	`E-DI-4005`	The domain is still in use by targets	No
400	`E-DI-4011`	Unable to resolve domain	No
400	`E-DI-4012`	Unable to find matching TXT record on domain	No
400	`E-DI-4020`	Unknown error	Maybe*
400	`E-DI-4021`	The file content did not match the expected value	No
400	`E-DI-4022`	Unexpected HTTP status	No
400	`E-DI-4023`	Unable to connect to the host	No
400	`E-DI-5001`	Message not found	No
400	`E-DI-5002`	Payload was too large	No
400	`E-DI-5003`	Cannot cancel message in the current state	No
400	`E-DI-5004`	Cannot reschedule already delivered messages	No
400	`E-DI-5005`	Monthly free tier limit reached	No

* Depending on the nature of the underlying error the problem may or may not be resolved by retrying. We advice only performing a small amount of retries in case the error is more permanent.

If you have any questions you can't find the answer for, please don't hesitate to contact us.