# Posts

Publishing posts to the Bitrix24 Feed: create, list, update, delete, and grant access to additional recipients.

Scope: `log`

## Operations

- [Create a post](./posts/create.md) — `POST /v1/posts`
- [List posts](./posts/list.md) — `GET /v1/posts`
- [Update a post](./posts/update.md) — `PATCH /v1/posts/:id`
- [Delete a post](./posts/delete.md) — `DELETE /v1/posts/:id`
- [Add recipients](./posts/share.md) — `POST /v1/posts/:id/share`

## Post addressing

The `recipients` parameter defines who sees the post. The following prefixes are supported:

| Value | Description |
|----------|---------|
| `UA` | All Bitrix24 account employees |
| `U1` | Employee with ID 1. List: `GET /v1/users` |
| `D1` | Department with ID 1, excluding sub-departments. List: `GET /v1/departments` |
| `DR1` | Department with ID 1, including sub-departments. List: `GET /v1/departments` |
| `SG5` | Workgroup or project with ID 5. List: `GET /v1/workgroups` |

Values are combined in an array: `["DR3", "U1", "SG5"]` — the post is seen by employees of department 3 including its sub-departments, employee 1, and members of group 5. If `recipients` is omitted or an empty array is passed, the default value `["UA"]` applies.

## See also

- [Comments](/docs/feed/comments)
- [Feed](/docs/feed)