Authentication - arg.ai

The arg.ai API uses API keys for authentication. API keys are long-lived credentials scoped to an organization. They can authenticate as your user account or as a service account. Pass the API key in the X-API-Key header:

curl https://api.arg.ai/api/workspaces \
  -H "X-API-Key: arg_your_api_key_here"

You can create an API key at arg.ai/platform/api-keys. User-owned keys inherit your current access within the key’s organization. Service-account keys inherit the role and grants of their service account, including API key management permissions when granted. See the API Keys guide for details on creating and managing keys programmatically.

Set up your environment

Export your key and the base URL so the examples in these guides work as-is:

export ARG_API_KEY="arg_live_your_key_here"
export ARG_API="https://api.arg.ai"

Error responses

Authentication errors return HTTP 401 with a JSON body:

{
  "detail": "Not authenticated"
}

If a valid token lacks permission for the requested resource, the API returns HTTP 403:

{
  "detail": "Insufficient permissions"
}