provisioning-api

GET /healthz

Healthz

GET /readyz

Readyz

POST /v1/assistants/{assistant_id}/activate

Activate Assistant

Activate an assistant after lifecycle-api confirms it is ready. Idempotent by construction (uppföljning till Task 14, D-67-mönstret men utan Idempotency-Key-header): assistenten är sin egen naturliga nyckel. Om assistant_id redan har en assistant_activated-rad i public.audit_events (provisioning_events.v1) är anropet en omkörning — samma 200-svar returneras utan att skriva en andra hash-kedjad rad, och UTAN att fråga lifecycle-api igen. Kontrollen görs alltså FÖRE dossier-checken: den lokala WORM-kedjan är sanningen om aktiveringen redan skett, oberoende av vad lifecycle-api för tillfället svarar (en omkörning ska ge samma resultat, inte bli gisslan hos ett flackande nedströms-tillstånd). En assistent som ännu inte aktiverats passerar fortfarande dossier-checken precis som förut. Requires tenant_admin role (enforced by upstream llm-gateway / platform-JWT in production; provisioning-api itself is an internal service in v1 with service-token auth, so role enforcement is noted as a comment for the v2 platform-JWT upgrade).

Kropp (valfri): ActivationRequest | null application/json

GET /v1/tenants

List Tenants

POST /v1/tenants

Create Tenant

Create a tenant. Idempotent by construction (spec §7): unik slug ⇒ 409 vid omkörning. Ingen Idempotency-Key behövs. Se D-67.

Kropp: CreateTenantRequest application/json

GET /v1/tenants/{tenant_id}

Get Tenant

POST /v1/tenants/{tenant_id}/exports

Trigger Export

Trigger a tenant-exit export (spec §5): fan-out to 5 platform-DB services, assemble + encrypt an artifact, WORM-audit every transition. Idempotens (spec §7, D-67): `Idempotency-Key` är FRIVILLIG men rekommenderad för maskinella anropare. Samma nyckel för samma tenant returnerar det befintliga jobbet (202, samma export_id) utan att starta en andra fan-out. Nyckeln är avsiktligt inte obligatorisk — till skillnad från webhook-ytan, som är en främmande avsändare (app/api/webhooks.py:44-45).

GET /v1/tenants/{tenant_id}/exports/{export_id}

Get Export Status

GET /v1/tenants/{tenant_id}/exports/{export_id}/download

Download Export

POST /v1/tenants/{tenant_id}/transitions/{action}

Transition Tenant

Transition a tenant's status. Idempotent by construction (spec §7): tillståndsmaskinen avvisar en upprepad övergång med InvalidTransitionError. Se D-67.

POST /v1/webhooks/events

Receive Event

Kropp: WebhookPayload application/json