Errors

Who this is for

Developers and admins troubleshooting API and workflow failures.

Goal

Understand error categories and how to resolve them.

Prereqs

• /api/authentication

Success criteria

You can identify the likely cause of an error and the next action.

Error categories

• Authentication errors: missing or invalid API keys
• Authorization errors: insufficient permissions
• Validation errors: missing or invalid fields
• Rate limits: too many requests in a short period
• Fulfillment errors: downstream connector issues

Example

If you see an authentication error, verify the Authorization: Owlie [APIKEY] header is present and correct.

Troubleshooting

• If a request fails intermittently, retry with backoff and check connector health.

Assumptions & Questions

• What are the exact error codes and messages used by the API?

Next steps

• /api/common-queries
• /troubleshooting/connector-failures