Provision org
For an overview of the full lifecycle, see Agent-created organizations.
POST
/v2/orgs/provisionFeatures
Send the token in the Authorization: Bearer API_TOKEN header. See Tokens for which token types this endpoint accepts.
Input2
Sent from your browser straight to the API — never to Docsbook, never stored.
Optional display name for the organization. If omitted, a name is auto-generated and the owner can rename it later.
Optional edge deployment (region) the organization is created in. If omitted, the environment's default region is used.
Output6
URL a human follows to claim ownership of the temporary org.
Full-permission API token the agent uses to create datasets, ingest, and query. Returned once and never retrievable again.
Responses
200Provisioned organization
429Rate limit exceeded. The provisioning rate limit has been reached; retry later with backoff.
Example input
curl -X POST 'https://api.axiom.co/v2/orgs/provision' \
-H 'Authorization: Bearer API_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"name":"string","edgeDeployment":"string"}'Example output
{
"id": "string",
"name": "string",
"defaultEdgeDeployment": "string",
"expiresAt": "2024-01-01T00:00:00Z",
"claimUrl": "string",
"token": "string"
}