> ## Documentation Index
> Fetch the complete documentation index at: https://yn-c9bb3266.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Onboarding

> Cancel an in-progress entity onboarding

## Path parameters

<ParamField path="entity_id" type="string" required>
  The entity identifier.
</ParamField>

<ParamField path="onboarding_id" type="string" required>
  The onboarding identifier to cancel.
</ParamField>

## Response

Returns the onboarding object with status `CANCELLED`.

<ResponseExample>
  ```json 200 OK theme={"theme":{"light":"github-dark","dark":"github-dark"}}
  {
    "id": "onb_990e8400-e29b-41d4-a716-446655440000",
    "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
    "yuno_account_id": "550e8400-e29b-41d4-a716-446655440000",
    "onboarding_type": "ONE_STEP",
    "status": "CANCELLED",
    "created_at": "2026-02-01T10:00:00Z",
    "updated_at": "2026-02-01T15:00:00Z"
  }
  ```

  ```json 400 Bad Request theme={"theme":{"light":"github-dark","dark":"github-dark"}}
  {
    "code": "INVALID_STATUS",
    "messages": ["Cannot cancel onboarding with terminal status"],
    "http_code": 400
  }
  ```
</ResponseExample>