Start a sole-trader onboarding workflow.

POST 
/v1/onboarding/sole-trader

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

The response body returns the initial WorkflowState (status INITIATED, workflowType: sole-trader); the Location header points at the status endpoint the client should poll for progress.

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.