---
title: "Record onboarding observations"
method: POST
path: "/onboarding/observations"
tags: ["onboarding"]
---

# Record onboarding observations

`POST /onboarding/observations`

Records bounded metadata-only client observations. Event identifiers deduplicate retries; these observations never assert successful business operations.

## Request body

- OnboardingRecordObservationsInput
  - `events` OnboardingJourneyObservationInput[], nullable, required
    - `active_ms` integer, nullable
    - `event_id` string, required
    - `kind` 'screen_entered' | 'screen_left' | 'active_interval' | 'resume_loaded' | 'operation_attempted' | 'operation_failed' | 'support_handoff', required
    - `operation` 'profile_confirmation' | 'registry_selection' | 'document_upload' | 'document_confirmation' | 'msa_signature' | 'service_agreement_signature' | 'signer_invitation' | 'w9_signature' | 'kyb_submission' | 'support_submission'
    - `screen` 'profile' | 'msa' | 'company' | 'people' | 'owners' | 'documents' | 'review' | 'service_agreements' | 'bank_account' | 'status' | 'unknown', required
    - `sequence` integer, required
    - `visit_id` string, required

## Response `200`

OK

- OnboardingRecordObservationsOutput
  - `accepted_count` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `503` — Service Unavailable
- `default` — Error response.

## Changes

- **2026-09-12** `322de176ce60` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/onboarding/observations/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) · [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/823fcbbd2f80?raw)