Start a company onboarding workflow.

POST 
/v1/onboarding/company

Starts a new Temporal workflow on onboarding-task-queue.

The body must include party.relationships[] referencing existing director partyIds (onboarded separately via /v1/onboarding/individual) and a single signatory block. The response body returns the initial WorkflowState (status INITIATED, workflowType: company); the Location header points at the status endpoint to poll.

Request

Responses

202

Workflow accepted — returns the initial WorkflowState. Poll the Location URL for progress.

Response Headers

Location

URL of the status endpoint for the new workflow.

401

Missing or invalid bearer token (GEN001*).

422

Request body fails schema validation (GEN000000).

500

Internal server error (GEN100000) or downstream Temporal failure.