People
Update your annotations on a person
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.
AuthorizationBearer <token>
API key minted via POST /v1/api-keys (format mk_live_...)
In: header
Path Parameters
idstring
Person id (aut_...).
Length
1 <= lengthtags?array<string>
Replaces the whole list.
Items
items <= 20notes?string
Length
length <= 2000muted?boolean
ownerId?string|null
The member who owns the contact (user id); null clears.
Length
1 <= lengthstage?string
Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit.
Value in
"not_contacted" | "contacted" | "replied" | "in_talks" | "customer" | "not_a_fit"Response Body
application/json
application/json
application/json
application/json
curl -X PATCH "https://api.mentio.dev/v1/people/aut_abc123" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "string",
"platform": "bluesky",
"name": "string",
"handle": "string",
"url": "string",
"avatarUrl": "string",
"accounts": [
{
"id": "string",
"platform": "bluesky",
"name": "string",
"handle": "string",
"url": "string"
}
],
"reach": {
"followers": 0,
"following": 0,
"posts": 0
},
"profile": {
"bio": "string",
"company": "string",
"location": "string",
"website": "string",
"email": "string",
"links": [
{
"provider": "string",
"url": "http://example.com"
}
],
"fetchedAt": "string"
},
"stats": {
"mentions": 0,
"relevant": 0,
"sentiment": {
"positive": 0,
"neutral": 0,
"negative": 0
},
"firstSeenAt": "string",
"lastSeenAt": "string"
},
"annotations": {
"tags": [
"string"
],
"notes": "string",
"muted": true
},
"outreach": {
"owner": {
"id": "string",
"name": "string",
"email": "string"
},
"stage": "not_contacted",
"lastContactedAt": "string"
}
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}