---
title: "Update Contact Interest"
method: PUT
path: "/api/contacts/{person_id}/interest"
tags: ["contacts", "contacts"]
---

# Update Contact Interest

`PUT /api/contacts/{person_id}/interest`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/contacts/{person_id}/interest`
- Auth: none declared

Manually update a contact's interest level.

CRITICAL: Interest level only upgrades automatically (never downgrades).
Manual updates bypass this rule to allow corrections.

## Path parameters

- `person_id` integer, required

## Request body

- InterestLevelUpdate: Request to update a contact's interest level.
  - `interest_level` string, required

## Response `200`

Successful Response

- InterestLevelResponse: Response for contact's interest level and outreach status.
  - `person_id` integer, required
  - `interest_level` string, required
  - `interest_last_updated_at` string, nullable
  - `outreach_paused` boolean, required
  - `outreach_paused_reason` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/d84e7dc9977d?raw)