authentication_required.

What it means.

The endpoint requires authentication and no bearer token was provided. Pass an Authorization: Bearer intelligence_… header.

Retry strategy.

The envelope returns retry_strategy: "retry_with_clarification" by default for this code.

The request needs a correction before it can succeed. Inspect error.message (and error.param when present), adjust the request, then retry.

Example error envelope.

Locked RFC-001 shape. The HTTP status is 401, the x-request-id header mirrors error.request_id, and the doc_url points back to this page.

{
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "The endpoint requires authentication and no bearer token was provided.",
    "doc_url": "https://www.orbytlabs.ai/intelligence/api/errors/authentication_required",
    "request_id": "req_0123456789abcdef",
    "retry_strategy": "retry_with_clarification",
    "retry_hint": {
      "clarification_needed": "See error.message for the parameter to correct"
    }
  }
}

How to fix it.

1. Inspect error.param to find which parameter the API rejected.
2. Read error.message and error.retry_hint.clarification_needed for the exact correction.
3. Re-issue the request with the corrected value. The fix is always client-side for this strategy.

Related codes.

Other codes in the authentication_error family.

Keep building.