Provision org

POST/v2/orgs/provision

Creates a temporary organization for an automated agent and returns a full-permission API token and a claim URL. The organization is deleted after 24 hours unless a human claims it. Doesn't require authentication and is rate limited per client IP.

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

Body

application/json

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

Request

curl -X POST 'https://api.axiom.co/v2/orgs/provision' \
  -H 'Content-Type: application/json' \
  -d '{"edgeDeployment":"string","name":"string"}'

Try itRun this request against your Axiom organization

This endpoint doesn’t require authentication.

Request body application/json

Response

200Provisioned organization.

application/json

400Invalid name or edge deployment.

429Rate limit exceeded, either for the client IP or for all callers. Retry later with backoff.

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