Skip to content
Authrim

Create a tenant database provisioning job.

POST
/api/admin/jobs/tenant-databases/provision
Code sample: Shell / cURL 
curl --request POST \
  --url https://auth.example.com/api/admin/jobs/tenant-databases/provision \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "tenant_slug": "acme", "generation": 2, "activate": false, "execution_mode": "plan_only", "reason": "Prepare the next tenant database generation." }'

Creates a tenant-database/provision deployment request for system storage operators. The Admin API records required operator steps but does not mutate Cloudflare D1 resources directly.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
tenant_slug
string
>= 1 characters <= 128 characters
generation
integer
>= 1
activate
boolean
execution_mode
string
default: plan_only
Allowed values: plan_only operator_cli
reason
string
>= 1 characters <= 500 characters
key
additional properties
Example 
{
  "tenant_slug": "acme",
  "generation": 2,
  "activate": false,
  "execution_mode": "plan_only",
  "reason": "Prepare the next tenant database generation."
}

Responses

Section titled “ Responses ”

202

Section titled “202 ”

Tenant database provisioning request accepted response.

Media type application/json
object
job_id
required
string
job_type
required
string
Allowed values: tenant-database/provision
status
required
string
Allowed values: pending
tenant_id
required
string
created_by
required
string
created_at
required
string format: date-time
key
additional properties
Example 
{
  "job_type": "tenant-database/provision",
  "status": "pending"
}

400

Section titled “400 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Section titled “401 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Section titled “403 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Section titled “409 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Section titled “500 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}