Overview

builders.ac Provisioning API v1alpha1

Not supported yet — internal testing only. The Provisioning API must not be used for production workflows. Endpoints and payloads may change without notice. Treat this reference as an internal-testing preview rather than a production contract.

Provision workspaces, domains, personas and Microsoft 365 inboxes, then track long-running infrastructure work through Operations. Authenticate with a shared builders.ac API Key and use the matching API Secret only to open sealed values and proof challenges.

Information

• OpenAPI version: 3.2.0

Operations

GET

/me

GET

/encryption-keys

GET

/workspaces

POST

/workspaces

GET

/workspaces/{wsp}

DELETE

/workspaces/{wsp}

PATCH

/workspaces/{wsp}

POST

/workspaces/{wsp}/archive

POST

/workspaces/{wsp}/unarchive

GET

/domains

GET

/domains/{dom}

DELETE

/domains/{dom}

PATCH

/domains/{dom}

PUT

/domains/{dom}/redirect

PUT

/domains/{dom}/sequencer

DELETE

/domains/{dom}/sequencer

POST

/domains/{dom}/clone

POST

/domains/{dom}/reconnect

POST

/domains/{dom}/renew

POST

/workspaces/{wsp}/domains/connect

POST

/workspaces/{wsp}/domains/buy

GET

/personas

POST

/workspaces/{wsp}/personas

GET

/personas/{per}

DELETE

/personas/{per}

PATCH

/personas/{per}

POST

/personas/deprovision

GET

/inboxes

POST

/domains/{dom}/inboxes

GET

/inboxes/{inb}

PATCH

/inboxes/{inb}

POST

/inboxes/deprovision

POST

/inboxes/upload

GET

/operations

GET

/operations/{op}

POST

/operations/{op}/cancel

GET

/provider-accounts

POST

/provider-accounts

GET

/provider-accounts/{pra}

DELETE

/provider-accounts/{pra}

PATCH

/provider-accounts/{pra}

GET

/

GET

/openapi.json

GET

/problems/{code}

GET

/problems

Authentication

bearerAuth

The shared builders.ac API Key (age1...) issued in the customer portal. Send the API Key as the Bearer token; the matching API Secret never crosses the wire.

Security scheme type: http