Provision org

POST/v2/orgs/provision

Publicly provisions a temporary organization intended for automated agents. The organization is marked temporary with a TTL and is deleted automatically if it is not claimed before it expires. The response includes a claim URL that lets a human take ownership of the org. This endpoint is unauthenticated and strict rate limits apply.

For an overview of the full lifecycle, see Agent-created organizations.

Body #

application/json

Property	Type	Description
`name`	`string`	Optional display name for the organization. If omitted, a name is auto-generated and the owner can rename it later.
`edgeDeployment`	`string`	Optional edge deployment (region) the organization is created in. If omitted, the environment's default region is used.

Request #

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"}'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token RequiredRequest body application/json

Response #

200Provisioned organization

application/json

429Rate limit exceeded. The provisioning rate limit has been reached; retry later with backoff.

Property	Type	Description
`id`	`string`Required
`name`	`string`Required
`defaultEdgeDeployment`	`string`Required
`expiresAt`	`string<date-time>`Required
`claimUrl`	`string`Required	URL a human follows to claim ownership of the temporary org.
`token`	`string`Required	Full-permission API token the agent uses to create datasets, ingest, and query. Returned once and never retrievable again.