API

unauthorized

HTTP 401. Authentication required

What it means

The operation needs a token and the request had none.

What to do

Send Authorization: Bearer rf_.... Create a token under Settings, API tokens in the web app, or sign in with rf login. See authentication.

Retrying

Do not retry the same request. Change it first.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/unauthorized",
  "title": "Authentication required",
  "status": 401,
  "detail": "Authentication is required. Send \"Authorization: Bearer rf_...\".",
  "instance": "/api/v1/orders",
  "code": "unauthorized",
  "request_id": "req_c4v8n2m6x1z3"
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.