---
title: "Record a visit disposition, preserving every submission"
method: POST
path: "/api/v1/field-providers/appointments/{appointment_id}/disposition/"
tags: ["Field Providers", "Field API — Visits"]
---

# Record a visit disposition, preserving every submission

`POST /api/v1/field-providers/appointments/{appointment_id}/disposition/`

## Request

- Base URL: `https://api.cloverhealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloverhealth.com/api/v1/field-providers/appointments/{appointment_id}/disposition/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cloverhealth/apis/clover-api/docs/api/v1/field-providers/appointments/:appointment_id/disposition/post.ts> (a function with typed inputs; its response is checked against the schema)

Accept corrections as new events; an exact retry returns its original event.

## Path parameters

- `appointment_id` string, uuid, required

## Request body

- VisitDispositionRequest
  - `disposition` 'completed' | 'cancelled' | 'rescheduled' | 'member_no_show', required
  - `occurred_at` string, date-time, required
  - `client_event_id` string, required

## Response `200`

OK

- VisitDispositionEventSchema
  - `id` integer, required
  - `appointment_id` string, required
  - `field_provider_id` string, required
  - `disposition` 'completed' | 'cancelled' | 'rescheduled' | 'member_no_show', required
  - `occurred_at` string, date-time, required
  - `created_at` string, date-time, required
  - `client_event_id` string, required

## Other responses

- `404`: Not Found
- `409`: Conflict

## Changes

- **2026-11-12** `aa6fe9fdf19f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloverhealth/apis/clover-api/changes/api/v1/field-providers/appointments/:appointment_id/disposition/post.md)

---

[API](https://skmtc.dev/cloverhealth/apis/clover-api.md) - [All operations](https://skmtc.dev/cloverhealth/apis/clover-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloverhealth/apis/clover-api/revisions/aa6fe9fdf19f?raw)