Administration API

The Administration API is for organization management and automation. It uses organization-owned Admin API keys, not the ak_... Project API keys used for model inference.

Credential	Use
Admin API key	Call `/v1/organization` management endpoints
`ak_...` Project API key	Call model inference endpoints for one project

Create the first Admin API key

Sign in to the Abliteration Console.
Select the organization you want to manage.
Open Admin API keys.
Select Create API key.
Choose the minimum permissions required for the integration.
Copy the key when it is shown. The full value is displayed once.

Only organization owners and admins can manage Admin API keys in the Console. An invited user must accept the invitation before their role becomes active.

Admin API keys are server-side credentials. Store them in a secret manager or environment variable. Do not commit them or expose them in browser code, mobile application bundles, or other public clients. Browser applications must call their own backend. Direct browser JavaScript access is unsupported.

Authenticate

Use the Production base URL and send the Admin API key as a bearer token:

export ABLITERATION_ADMIN_KEY="your-admin-api-key"

curl https://api.abliteration.ai/v1/organization \
  -H "Authorization: Bearer $ABLITERATION_ADMIN_KEY"

An Admin API key is bound to one organization. The API derives the organization from the credential; requests do not accept an organization ID override.

Permissions

Each key has explicit permissions. A key can create another Admin API key only with a subset of its own permissions.

Permission	Access
`organization:read`	Read organization metadata
`projects:read`	List and retrieve projects
`projects:create`	Create, rename, and archive projects
`project_api_keys:read`	List and retrieve Project API keys
`project_api_keys:create`	Create Project API keys
`project_api_keys:revoke`	Revoke Project API keys
`admin_api_keys:read`	List and retrieve Admin API keys
`admin_api_keys:create`	Create Admin API keys
`admin_api_keys:revoke`	Revoke Admin API keys
`billing:read`	Read balances, usage, and costs
`spend_limits:read`	Read organization and project spend limits
`spend_limits:write`	Set and delete organization and project spend limits
`policies:read`	Read policies, published versions, and effective project policies
`policies:write`	Create, edit, publish, pause, resume, and delete policies

Idempotent creates

Project creation, policy creation, Project API-key creation, and Admin API-key creation require an Idempotency-Key header between 8 and 200 characters. Reusing a key with the same request returns the original result. Reusing it with a different request returns 409 idempotency_conflict. An idempotent retry of API-key creation can return the same creation response, including the secret. Protect retry responses and do not log them. If a retry returns 409 idempotency_reconciliation_required, review the organization’s Admin API keys before using a new idempotency key. Follow the recovery steps in Administration API errors.

curl https://api.abliteration.ai/v1/organization/projects \
  -X POST \
  -H "Authorization: Bearer $ABLITERATION_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: project-create-20260930-01" \
  -d '{"name":"Production"}'

Next steps

Browse the Administration API resources in the sidebar for generated request and response reference.
See Manage policies for the draft and publish workflow.
See Administration API errors for error handling and rate-limit headers.

Start here

Inference API

Administration API

Create the first Admin API key

Authenticate

Permissions

Idempotent creates

Next steps

​Create the first Admin API key

​Authenticate

​Permissions

​Idempotent creates

​Next steps

Create the first Admin API key

Authenticate

Permissions

Idempotent creates

Next steps