# Пачка API — методы и основы

> Индекс раздела API: основы (авторизация, пагинация, ошибки, лимиты, файлы) и все методы по группам. Каждая ссылка ведёт на `.md` (или добавь `Accept: text/markdown`).

[Родительский индекс](https://dev.pachca.com/llms.txt)

## Основы API
- [Обзор](https://dev.pachca.com/api/overview.md): Обзор REST API Пачки: базовый URL, авторизация по Bearer-токену, формат запросов и ответов, клиенты и SDK для CLI, TypeScript, Python, Go, Kotlin, Swift и C#
- [Авторизация](https://dev.pachca.com/api/authorization.md): Авторизация в API Пачки: какой токен выбрать, персональный токен и токен бота, токен по авторизации для ботов и программ с MCP, скоупы методов, headless-интеграции для агентов, кто может создавать токены и вкладка «Все токены» для администраторов
- [Запросы и ответы](https://dev.pachca.com/api/requests-responses.md): Формат запросов и ответов API Пачки: базовый URL, заголовки Authorization и Content-Type, запросы с сервера вместо браузера, структура JSON-тела и ответа, где взять идентификаторы чатов, сотрудников и тредов, коллекции Postman и Bruno
- [Пагинация](https://dev.pachca.com/api/pagination.md): Пагинация в API Пачки по курсору: две группы методов (списочные и поиск) с разной структурой meta, поля next_page, prev_page, has_next, has_prev, обход всех записей и polling новых данных через prev_page
- [Файлы](https://dev.pachca.com/api/file-uploads.md): Файлы в API Пачки: трёхшаговая загрузка через presigned URL S3, типы вложений и их поля, ссылка на скачивание и когда она ведёт не в хранилище, а на адрес API, размер и имя файла без скачивания
- [Ошибки](https://dev.pachca.com/api/errors.md): Коды ошибок HTTP в API Пачки и структуры тела ответа: ApiError (400/402/403/404/409/410/422/429/503/504) и OAuthError (401/403) с описанием полей и кодов
- [Лимиты](https://dev.pachca.com/api/limits.md): Лимиты запросов (rate limits) в API Пачки: общий предел и лимиты по типам операций, ответ 429 и заголовок Retry-After, длина текста сообщения, автоматические повторы в SDK, CLI и n8n, готовые примеры backoff на TypeScript и Python
- [Модели](https://dev.pachca.com/api/models.md): Справочник моделей данных Pachca API (сотрудники, чаты, сообщения, черновики, напоминания, теги, вебхуки и другие сущности): свойства каждой модели и методы, которые с ней работают

## OAuth и токены
- [Отзыв токена](https://dev.pachca.com/api/oauth/revoke-token.md): POST /oauth/revoke
- [Обмен кода на токен](https://dev.pachca.com/api/oauth/exchange-token.md): POST /oauth/token
- [Информация о токене](https://dev.pachca.com/api/oauth/token-info.md): GET /oauth/token/info

## Чаты
- [Новый чат](https://dev.pachca.com/api/chats/create.md): POST /chats
- [Список чатов](https://dev.pachca.com/api/chats/list.md): GET /chats
- [Экспорт сообщений](https://dev.pachca.com/api/chats/request-export.md): POST /chats/exports
- [Скачать архив экспорта](https://dev.pachca.com/api/chats/download-export.md): GET /chats/exports/{id}
- [Информация о чате](https://dev.pachca.com/api/chats/get.md): GET /chats/{id}
- [Редактирование чата](https://dev.pachca.com/api/chats/update.md): PUT /chats/{id}
- [Архивация чата](https://dev.pachca.com/api/chats/archive.md): PUT /chats/{id}/archive
- [Загрузка аватара чата](https://dev.pachca.com/api/chats/update-avatar.md): PUT /chats/{id}/avatar
- [Удаление аватара чата](https://dev.pachca.com/api/chats/remove-avatar.md): DELETE /chats/{id}/avatar
- [Разархивация чата](https://dev.pachca.com/api/chats/unarchive.md): PUT /chats/{id}/unarchive
- [Отметка чата непрочитанным](https://dev.pachca.com/api/chats/mark-unread.md): PUT /chats/{id}/unread
- [Список чатов пространства](https://dev.pachca.com/api/chats/list-company.md): GET /company/chats

## Профиль и статус
- [Свой профиль](https://dev.pachca.com/api/profile/get.md): GET /profile
- [Загрузка своего аватара](https://dev.pachca.com/api/profile/update-avatar.md): PUT /profile/avatar
- [Удаление своего аватара](https://dev.pachca.com/api/profile/delete-avatar.md): DELETE /profile/avatar
- [Свой статус](https://dev.pachca.com/api/profile/get-status.md): GET /profile/status
- [Новый свой статус](https://dev.pachca.com/api/profile/update-status.md): PUT /profile/status
- [Удаление своего статуса](https://dev.pachca.com/api/profile/delete-status.md): DELETE /profile/status

## Сотрудники
- [Новый сотрудник](https://dev.pachca.com/api/users/create.md): POST /users
- [Список сотрудников](https://dev.pachca.com/api/users/list.md): GET /users
- [Информация о сотруднике](https://dev.pachca.com/api/users/get.md): GET /users/{id}
- [Редактирование сотрудника](https://dev.pachca.com/api/users/update.md): PUT /users/{id}
- [Удаление сотрудника](https://dev.pachca.com/api/users/delete.md): DELETE /users/{id}
- [Загрузка аватара сотрудника](https://dev.pachca.com/api/users/update-avatar.md): PUT /users/{user_id}/avatar
- [Удаление аватара сотрудника](https://dev.pachca.com/api/users/remove-avatar.md): DELETE /users/{user_id}/avatar
- [Статус сотрудника](https://dev.pachca.com/api/users/get-status.md): GET /users/{user_id}/status
- [Новый статус сотрудника](https://dev.pachca.com/api/users/update-status.md): PUT /users/{user_id}/status
- [Удаление статуса сотрудника](https://dev.pachca.com/api/users/remove-status.md): DELETE /users/{user_id}/status

## Теги
- [Новый тег](https://dev.pachca.com/api/group-tags/create.md): POST /group_tags
- [Список тегов](https://dev.pachca.com/api/group-tags/list.md): GET /group_tags
- [Информация о теге](https://dev.pachca.com/api/group-tags/get.md): GET /group_tags/{id}
- [Редактирование тега](https://dev.pachca.com/api/group-tags/update.md): PUT /group_tags/{id}
- [Удаление тега](https://dev.pachca.com/api/group-tags/delete.md): DELETE /group_tags/{id}
- [Список сотрудников тега](https://dev.pachca.com/api/group-tags/list-users.md): GET /group_tags/{id}/users

## Участники чатов
- [Добавление тегов](https://dev.pachca.com/api/members/add-group-tags.md): POST /chats/{id}/group_tags
- [Исключение тега из чата](https://dev.pachca.com/api/members/remove-group-tag.md): DELETE /chats/{id}/group_tags/{tag_id}
- [Выход из чата](https://dev.pachca.com/api/members/leave.md): DELETE /chats/{id}/leave
- [Список участников чата](https://dev.pachca.com/api/members/list.md): GET /chats/{id}/members
- [Добавление участников](https://dev.pachca.com/api/members/add.md): POST /chats/{id}/members
- [Исключение участника](https://dev.pachca.com/api/members/remove.md): DELETE /chats/{id}/members/{user_id}
- [Редактирование роли участника](https://dev.pachca.com/api/members/update.md): PUT /chats/{id}/members/{user_id}

## Треды
- [Новый тред](https://dev.pachca.com/api/threads/add.md): POST /messages/{id}/thread
- [Новый самостоятельный тред](https://dev.pachca.com/api/threads/create.md): POST /threads
- [Список тредов](https://dev.pachca.com/api/threads/list.md): GET /threads
- [Информация о треде](https://dev.pachca.com/api/threads/get.md): GET /threads/{id}

## Сообщения
- [Новое сообщение](https://dev.pachca.com/api/messages/create.md): POST /messages
- [Список сообщений чата](https://dev.pachca.com/api/messages/list.md): GET /messages
- [Информация о сообщении](https://dev.pachca.com/api/messages/get.md): GET /messages/{id}
- [Редактирование сообщения](https://dev.pachca.com/api/messages/update.md): PUT /messages/{id}
- [Удаление сообщения](https://dev.pachca.com/api/messages/delete.md): DELETE /messages/{id}
- [Unfurl (разворачивание ссылок)](https://dev.pachca.com/api/messages/unfurl.md): POST /messages/{id}/link_previews
- [Закрепление сообщения](https://dev.pachca.com/api/messages/pin.md): POST /messages/{id}/pin
- [Открепление сообщения](https://dev.pachca.com/api/messages/unpin.md): DELETE /messages/{id}/pin

## Прочтение сообщения
- [Список прочитавших сообщение](https://dev.pachca.com/api/read-member/list-readers.md): GET /messages/{id}/read_member_ids

## Реакции на сообщения
- [Добавление реакции](https://dev.pachca.com/api/reactions/add.md): POST /messages/{id}/reactions
- [Удаление реакции](https://dev.pachca.com/api/reactions/remove.md): DELETE /messages/{id}/reactions
- [Список реакций](https://dev.pachca.com/api/reactions/list.md): GET /messages/{id}/reactions

## Важное
- [Список важных сообщений](https://dev.pachca.com/api/important-messages/list.md): GET /important_messages
- [Добавление сообщения в важные](https://dev.pachca.com/api/important-messages/create.md): POST /important_messages
- [Удаление сообщения из важных](https://dev.pachca.com/api/important-messages/delete.md): DELETE /important_messages/{id}

## Поиск
- [Поиск чатов](https://dev.pachca.com/api/search/list-chats.md): GET /search/chats
- [Поиск сообщений](https://dev.pachca.com/api/search/list-messages.md): GET /search/messages
- [Поиск сотрудников](https://dev.pachca.com/api/search/list-users.md): GET /search/users

## Напоминания
- [Новое напоминание](https://dev.pachca.com/api/tasks/create.md): POST /tasks
- [Список напоминаний](https://dev.pachca.com/api/tasks/list.md): GET /tasks
- [Информация о напоминании](https://dev.pachca.com/api/tasks/get.md): GET /tasks/{id}
- [Редактирование напоминания](https://dev.pachca.com/api/tasks/update.md): PUT /tasks/{id}
- [Удаление напоминания](https://dev.pachca.com/api/tasks/delete.md): DELETE /tasks/{id}

## Черновики
- [Новый черновик](https://dev.pachca.com/api/drafts/create.md): POST /drafts
- [Список черновиков](https://dev.pachca.com/api/drafts/list.md): GET /drafts
- [Информация о черновике](https://dev.pachca.com/api/drafts/get.md): GET /drafts/{id}
- [Редактирование черновика](https://dev.pachca.com/api/drafts/update.md): PUT /drafts/{id}
- [Удаление черновика](https://dev.pachca.com/api/drafts/delete.md): DELETE /drafts/{id}

## Формы
- [Открытие представления](https://dev.pachca.com/api/views/open.md): POST /views/open
- [Ответ на отправку формы](https://dev.pachca.com/api/views/submit-response.md): POST /views/{view_id}/submit_response

## Боты и Webhook
- [Ротация собственного токена бота](https://dev.pachca.com/api/bots/recreate-token-self.md): POST /bot/recreate_token
- [Саморегистрация вебхука бота](https://dev.pachca.com/api/bots/update-webhook.md): PUT /bot/webhook
- [Список ботов](https://dev.pachca.com/api/bots/list.md): GET /bots
- [Новый бот](https://dev.pachca.com/api/bots/create.md): POST /bots
- [Информация о боте](https://dev.pachca.com/api/bots/get.md): GET /bots/{id}
- [Редактирование бота](https://dev.pachca.com/api/bots/update.md): PUT /bots/{id}
- [Удаление бота](https://dev.pachca.com/api/bots/delete.md): DELETE /bots/{id}
- [Загрузка аватара бота](https://dev.pachca.com/api/bots/update-avatar.md): PUT /bots/{id}/avatar
- [Удаление аватара бота](https://dev.pachca.com/api/bots/remove-avatar.md): DELETE /bots/{id}/avatar
- [Ротация токена бота](https://dev.pachca.com/api/bots/recreate-token.md): POST /bots/{id}/recreate_token
- [Ротация секрета клиента](https://dev.pachca.com/api/bots/rotate-client-secret.md): POST /bots/{id}/rotate_client_secret
- [Каталог прав бота](https://dev.pachca.com/api/bots/list-scopes.md): GET /bots/{id}/scopes
- [Список токенов бота](https://dev.pachca.com/api/bots/list-tokens.md): GET /bots/{id}/tokens
- [Новый токен бота](https://dev.pachca.com/api/bots/create-token.md): POST /bots/{id}/tokens
- [Изменение токена бота](https://dev.pachca.com/api/bots/update-token.md): PUT /bots/{id}/tokens/{token_id}
- [Удаление токена бота](https://dev.pachca.com/api/bots/delete-token.md): DELETE /bots/{id}/tokens/{token_id}
- [Перевыпуск токена бота](https://dev.pachca.com/api/bots/reissue-token.md): POST /bots/{id}/tokens/{token_id}/reissue
- [Список ботов пространства](https://dev.pachca.com/api/bots/list-company.md): GET /company/bots
- [История событий](https://dev.pachca.com/api/bots/list-events.md): GET /webhooks/events
- [Поток событий](https://dev.pachca.com/api/bots/get-stream.md): GET /webhooks/events/stream
- [Удаление события истории](https://dev.pachca.com/api/bots/remove-event.md): DELETE /webhooks/events/{id}

## Безопасность
- [Журнал аудита событий](https://dev.pachca.com/api/security/list.md): GET /audit_events

## Дополнительные поля
- [Список дополнительных полей](https://dev.pachca.com/api/custom-properties/list.md): GET /custom_properties

## Файлы
- [Загрузка файла](https://dev.pachca.com/api/files/direct-url.md): POST /direct_url
- [Скачивание файла](https://dev.pachca.com/api/files/get.md): GET /files/{id}
- [Получение подписи, ключа и других параметров](https://dev.pachca.com/api/files/uploads.md): POST /uploads