Skip to main content
The MEMO API authenticates via request headers. The gateway accepts 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:
Use the 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):
Then call with the X-API-Key header — no JWT lifecycle to maintain:
On the China site use host 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 returns 401; insufficient role returns 403. The error body is uniform: