Authorization: Bearer <jwt> or X-API-Key: <sk_aria_...>, equivalently. Omitting both returns 401 Unauthorized.
Obtaining credentials
Option A: Account + JWT
Register or log in to get a JWT:token from login as the Bearer for later calls:
Option B: API Key
After logging in with a JWT, create an API key (shown only once):X-API-Key header — no JWT lifecycle to maintain:
https://memo.ariacompute.cn.
Workspace RBAC
Every business endpoint except/v1/auth/* and /v1/apikeys lives under a workspace and checks the caller’s role there. Roles from lowest to highest:
Each endpoint notes its minimum required role in its Authentication section. Insufficient role returns
403 Forbidden.
Error responses
When auth is required but the credential is missing or invalid, the API returns401; insufficient role returns 403. The error body is uniform: