> For the complete documentation index, see [llms.txt](https://docs.popl.co/introduction/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.popl.co/introduction/leads/tags.md).

# Tags

**List Tags:**

```yaml
GET /api/pub/tags
```

**Add a tag to a lead:** 

```yaml
PUT /api/pub/lead/{leadId}/tags?userId=123
```

Params: leadId (number): the lead ID. userId (number): the user ID from the lead.

Body: \
\- userId (number): the user ID from the lead. \
\- tagIds (list of numbers): the tag IDs. For tag IDs, the tags are expected to be base 10 numbers. For This list will accept a maximum of 10 tags at a time.

**Remove a tag from a lead:** 

```yaml
DELETE /api/pub/lead/{leadId}/tags?userId=123
```

Params: leadId (number): the lead ID. userId (number): the user ID from the lead.

Body: \
\- userId (number): the user ID from the lead. \
\- tagIds (list of numbers): the tag IDs. For tag IDs, the tags are expected to be base 10 numbers. For This list will accept a maximum of 10 tags at a time.