API Error Responses

Estimated reading: 1 minute 6 views

Overview

API error responses explain why a request failed and how the integration should react.

Status	Meaning	Typical fix
`400`	Bad request	Check query parameters.
`401`	Unauthorized	Check API key header.
`403`	Forbidden	Check scope.
`404`	Not found	Check endpoint URL.
`429`	Too many requests	Slow down and retry later.
`500`	Server error	Check server logs and Plugin Health.

{
  "success": false,
  "error": {
    "code": "missing_scope",
    "message": "This API key does not have permission to access activity logs."
  }
}

Retry only when the error is temporary. Do not repeatedly retry 401, 403, or validation errors without fixing the request.