---
title: "Update a person"
description: "Changes your workspace's tags, notes and mute for the person, and the outreach owner and stage. The owner must be a workspace member, and null removes it. Muting hides their posts from your feed and all channels. Collection and billing do not change."
canonical: https://docs.rumoro.dev/api/people/update-person
markdown: https://docs.rumoro.dev/api/people/update-person.mdx
---

# Update a person

`PATCH /v1/people/{id}`

Changes your workspace's tags, notes and mute for the person, and the outreach owner and stage. The owner must be a workspace member, and null removes it. Muting hides their posts from your feed and all channels. Collection and billing do not change.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The person's id (aut_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `tags` |  | Sets the full new list. |
| `notes` |  |  |
| `muted` |  |  |
| `ownerId` |  | The user id of the member responsible for this contact. Null removes it. |
| `stage` |  | The outreach stage your team has reached with this person. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The person after the change |
| 400 | The body is not valid, or the owner is not in the workspace |
| 401 | The API key is missing or not valid |
| 404 | Your workspace has no mention by this person |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).