> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postsyncer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List people

> Who can be @mentioned in a post's team comments

## List people

Everyone in the post's workspace (the owner and active members), sorted by name. Pass their `id` values as `mentions` when you [create](https://docs.postsyncer.com/api-reference/comments/create.md) or [update](https://docs.postsyncer.com/api-reference/comments/update.md) a team comment.

Requires the **`comments:read`** permission, like listing comments.

### Path

**post** `integer` *required*

Post id (must belong to a workspace you can access).

```bash theme={null}
curl -X GET "https://postsyncer.com/api/v1/posts/123/people" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json theme={null}
{
  "data": [
    { "id": 42, "name": "Bob Tesfaye", "avatar": "https://..." },
    { "id": 7, "name": "Sara Lee", "avatar": null }
  ]
}
```

### Response

`data`: each person as `{ "id", "name", "avatar" }`. `avatar` is `null` when the person has no picture. Email addresses are never included.

### Errors

`401` · `403` (key lacks `comments:read`) · `404` (post not found or not accessible)

See [Comments overview](https://docs.postsyncer.com/api-reference/comments/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.