Create a multi-tenant form submission (v2)

POST 
/v2/forms/submissions

Creates a canonical form submission and fans out practitioner/facility crosswalk creation to multiple tenants in parallel. Returns per-tenant results with an aggregated status of success, partial_success, or failed. GCS document uploads are dispatched as Cloud Tasks asynchronously.

Request

Responses

201

Canonical form submission created. Per-tenant results in tenantResults. HTTP 201 is returned even on partial_success or failed fan-out outcomes.

400

Bad request: validation failure (empty tenantIds, mutual exclusion, invalid URLs, etc.)

401

Unauthorized: valid JWT is required.

403

Forbidden: insufficient permissions.

500

Internal server error: unexpected error.

502

Bad gateway: the DAL returned a null, non-object, or id-less canonical submission response.

503

Service unavailable: the v2 feature is currently disabled via kill switch.