---
title: "Update your annotations on a person"
description: "Tags, notes, mute, and the outreach owner (a workspace member; null clears) and stage, for your workspace only. Mute hides their posts from your feed and every channel; ingest and billing never change."
canonical: https://docs.mentio.dev/api/people/update-person
markdown: https://docs.mentio.dev/api/people/update-person.mdx
---

# Update your annotations on a person

`PATCH /v1/people/{id}`

Tags, notes, mute, and the outreach owner (a workspace member; null clears) and stage, for your workspace only. Mute hides their posts from your feed and every channel; ingest and billing never change.

## Parameters

- `id` (path, required): Person id (aut_...).

## Body

- `tags`: Replaces the whole list.
- `notes`: string
- `muted`: boolean
- `ownerId`: The member who owns the contact (user id); null clears.
- `stage`: Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit.

## Responses

- 200: The updated person
- 400: Invalid body, or the owner is not a workspace member
- 401: Missing or invalid API key
- 404: No mention by this person for your workspace

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx