---
title: "Record a contact-level lead disposition (interest status, notes, tags)."
method: POST
path: "/leads/disposition"
tags: ["leads"]
---

# Record a contact-level lead disposition (interest status, notes, tags).

`POST /leads/disposition`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/leads/disposition`
- Auth: HTTP bearer

Upserts the durable, contact-level lead_dispositions row keyed by email — visible across every campaign that lists the contact. A partial patch: only the fields you pass are changed; at least one of interestStatus, notes, or tags is required.

## Request body

- UpdateLeadInput: At least one of interestStatus, notes, or tags must be present — a call with none has nothing to persist.
  - `email` string, email, required
  - `interestStatus` 'none' | 'interested' | 'meeting_booked' | 'not_now' | 'not_interested' | 'bad_fit' | 'out_of_office' | 'wrong_person': out_of_office reschedules the follow-up past the return date instead of treating silence as disinterest; wrong_person drives a referral ask. do_not_contact is deliberately not a member — that intent routes to POST /leads/suppress instead.
  - `notes` string
  - `tags` string[]

## Response `200`

Disposition upserted.

- LeadDispositionView
  - `email` string, required
  - `interestStatus` 'none' | 'interested' | 'meeting_booked' | 'not_now' | 'not_interested' | 'bad_fit' | 'out_of_office' | 'wrong_person', required: out_of_office reschedules the follow-up past the return date instead of treating silence as disinterest; wrong_person drives a referral ask. do_not_contact is deliberately not a member — that intent routes to POST /leads/suppress instead.
  - `notes` string, required
  - `tags` string[], required
  - `source` 'dashboard' | 'mcp' | 'api' | 'system', required
  - `updatedAt` integer, required

## Other responses

- `400`: Request body failed schema validation.
- `401`: Missing, invalid, or inactive bearer token.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)