Error Messages

Common error types & patterns you may encounter.

The status of API requests are indicated by standard HTTP response codes.

The response body of a failed API request will be JSON encoded, containing details about the error. The errors will be described in RFC 7807 format

See below for an example of when a request is made without an API key, which will return a status code of 401 Unauthorized:

{
  "title": "invalid-access-token"
  "detail": "The API Key provided is not valid",
  "type": "https://reference.airbyte.com/reference/errors#invalid-api-key",
  "status": "401",
}

Errors always contain at least three keys, title, detail, type.

  • title (string) - A short, human-readable title for the general error type; the title should not change for given types.
  • detail (string) - A human-readable description of the specific error.
  • type (string) - A URL to a document describing the error condition (optional, and "about:blank" is assumed if none is provided; should resolve to a human-readable document).
  • status (string) - The status code of the error, which should match the HTTP status code.

You can follow the type link for more information about the error and steps to help resolve the issue.

400 Resource Not Found

Resource Not Found is raised when the id presented in the request cannot be found for the given resource type. For instance, if a UUID of a Connection does not match a Connection in a Workspace that the Access Token has access to, then the Resource Not Found error will be raised.

401 Invalid API Key

Invalid API Key error will be raised if the API Key cannot be verified. Ensure the entire API key is copied correctly and the Authorization header is used. The Authorization headers value must also start with Bearer, followed by a space, then the token.

403 Forbidden

Forbidden error will be raised if the user doesn't have access to the specified resource (or the related workspace/organization). Check the resource you're trying to read/edit and ensure that you actually have access to the resource/containing workspace/containing organization before trying again.

409 Try Again Later

Try Again Later means that your request was valid, but the resource was currently busy. For instance, if a sync is already running, calling sync again will raise the Try Again Later error, as you can only have one sync running simultaneously.

409 State Conflict

State Conflict means that your request was valid, but there's some conflict with the state of the resource you're attempting to act on. For instance, if a sync is already already in a terminal status but you attempt to cancel it, we'll return you a conflict error since running that operation on an already canceled job isn't a valid state on the server.

422 Unprocessable Entity

Unprocessable Entity means that your request was valid, but the payload sent was not in the correct form. For instance, if you were POSTing at an endpoint to create a resource and that resource was missing a required field, an Unprocessable Entity error will be raised. The error message should include details on what was wrong with the payload sent to Airbyte.

422 Invalid Redirect URL

Invalid Redirect URL means that an invalid redirect URL was provided to us when initiating OAuth for a source or destination. If you see this error, please initiate OAuth with a valid redirect URL.

Your redirect URL should be an HTTPS URL like https://example.com.

500 Invalid Consent URL

Invalid Consent URL means that an unexpected error occurred during the generation of your OAuth consent URL. If you see this error, please reach out to the Airbyte support team and reference this page.

500 No User Found

No User Found means that an unexpected error occurred when attempting to locate your user in our Cloud service. If you see this error, please reach out to the Airbyte support team and reference this page. Self-hosted OSS users should not see this error.