API Reference / Update a lead's labels
Update a lead's labels
PATCH/api/v1/leads/{id}
Set vertical, archetype and tags on a lead. The one write on a lead.
curl -X PATCH -H "Authorization: Bearer $REVNU_API_TOKEN" \
-H "content-type: application/json" \
-d '{"vertical":"hpc","archetype":"operator","tags":["eu","gpu"]}' \
https://revnu.com/api/v1/leads/sn7…Body
Any of vertical, archetype (strings, at most 120 characters) and tags (up to 20 strings of at most 64 characters, deduplicated, order kept). null clears a field. Unknown fields are a 400, so a typo never silently does nothing.
Response
{ "lead": { … } }, the updated lead. Status, drafts, contacts and research stay read-only; the agent and the dashboard own them. 404 for an unknown or another account's lead.
Agents: this page is also markdown at /docs/lead-update.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
`leads:write`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.