pachca

name	pachca
description	Interact with the Pachca corporate messenger API — send messages, manage chats, users, tags, tasks, handle webhooks, upload files, and build bots. Use when integrating with Pachca or automating team communication workflows.
metadata	{"author":"pachca","version":"1.0"}

Pachca API

Pachca is a corporate messenger for teams. The REST API lets you automate communication workflows: send and manage messages, organize chats and channels, manage users and permissions, build interactive bots, handle file uploads, and react to real-time events via webhooks.

Base URL: https://api.pachca.com/api/shared/v1

Accessing Documentation

Format	URL	Best for
LLM-friendly summary	https://dev.pachca.com/llms.txt	Quick overview with links
Full documentation	https://dev.pachca.com/llms-full.txt	Complete reference in one file
OpenAPI 3.0 spec	https://dev.pachca.com/openapi.yaml	Programmatic parsing and code generation

For detailed endpoint documentation, parameters, and response schemas, fetch /llms-full.txt.

CLI (recommended)

# Zero-install
npx @pachca/cli <command> --token <TOKEN>

# For regular use
npm install -g @pachca/cli && pachca auth login

Authentication

All requests require a Bearer token. With CLI, use --token flag or PACHCA_TOKEN env var.

For direct API calls, add the Authorization header:

Authorization: Bearer <access_token>

Token types and their permissions:

• Admin token — full access: manage users, tags, delete messages. Get it in Settings → Automations → API.
• Owner token — admin access plus audit events and data export (Corporation plan only).
• Bot token — send messages with custom display name/avatar, receive webhook events, manage webhook settings. Created per-bot in Settings → Automations.

Tokens are long-lived and do not expire. They can be reset by the admin/owner in Settings.

Capabilities

Common

• POST /chats/exports — Request export
• GET /chats/exports/{id} — Download export
• GET /custom_properties — List properties
• POST /direct_url — Upload file
• POST /uploads — Get upload params

Profile

• GET /oauth/token/info — Get token info
• GET /profile — Get profile
• PUT /profile/avatar — Update profile avatar
• DELETE /profile/avatar — Delete profile avatar
• GET /profile/status — Get status
• PUT /profile/status — Update status
• DELETE /profile/status — Delete status

Users

• POST /users — Create user
• GET /users — List users
• GET /users/{id} — Get user
• PUT /users/{id} — Update user
• DELETE /users/{id} — Delete user
• PUT /users/{user_id}/avatar — Update user avatar
• DELETE /users/{user_id}/avatar — Delete user avatar
• GET /users/{user_id}/status — Get user status
• PUT /users/{user_id}/status — Update user status
• DELETE /users/{user_id}/status — Delete user status

Group tags

• POST /group_tags — Create tag
• GET /group_tags — List tags
• GET /group_tags/{id} — Get tag
• PUT /group_tags/{id} — Update tag
• DELETE /group_tags/{id} — Delete tag
• GET /group_tags/{id}/users — Get tag users

Chats

• POST /chats — Create chat
• GET /chats — List chats
• GET /chats/{id} — Get chat
• PUT /chats/{id} — Update chat
• PUT /chats/{id}/archive — Archive chat
• PUT /chats/{id}/unarchive — Unarchive chat

Members

• POST /chats/{id}/group_tags — Add tags
• DELETE /chats/{id}/group_tags/{tag_id} — Remove tag
• DELETE /chats/{id}/leave — Leave chat
• GET /chats/{id}/members — List members
• POST /chats/{id}/members — Add members
• DELETE /chats/{id}/members/{user_id} — Remove member
• PUT /chats/{id}/members/{user_id} — Update member role

Threads

• POST /messages/{id}/thread — Create thread
• GET /threads/{id} — Get thread

Messages

• POST /messages — Create message
• GET /messages — List chat messages
• GET /messages/{id} — Get message
• PUT /messages/{id} — Update message
• DELETE /messages/{id} — Delete message
• POST /messages/{id}/pin — Pin message
• DELETE /messages/{id}/pin — Unpin message

Read members

• GET /messages/{id}/read_member_ids — List read members

Reactions

• POST /messages/{id}/reactions — Add reaction
• DELETE /messages/{id}/reactions — Remove reaction
• GET /messages/{id}/reactions — List reactions

Link Previews

• POST /messages/{id}/link_previews — Create link previews

Search

• GET /search/chats — Search chats
• GET /search/messages — Search messages
• GET /search/users — Search users

Tasks

• POST /tasks — Create task
• GET /tasks — List tasks
• GET /tasks/{id} — Get task
• PUT /tasks/{id} — Update task
• DELETE /tasks/{id} — Delete task

Views

• POST /views/open — Open view

Bots

• PUT /bots/{id} — Update bot
• GET /webhooks/events — Get webhook events
• DELETE /webhooks/events/{id} — Delete webhook event

Security

• GET /audit_events — Get audit events

Common Workflows

CLI Quick Start

npx @pachca/cli <command> --token <TOKEN>

Find chat by name and send message

1. List all chats, find by name field: pachca chats list --all

   GET /chats does not support name search — paginate through all

2. Send message to the chat: pachca messages create --entity-id=<chat_id> --content="Hello"

Find active chats in a date range

1. List chats with activity after a date: pachca chats list --last-message-at-after=<date> --all

   Add --last-message-at-before for range. Date in ISO-8601 UTC

Set up a bot with outgoing webhook

1. Create bot in Pachca UI: Automations → Integrations → Webhook
2. Get access_token from bot API settings tab
3. Set Webhook URL to receive events

Show interactive form to user

1. Send message with button: pachca messages create --entity-id=<chat_id> --content="Fill the form" --buttons='[[{"text":"Open","data":"open_form"}]]'
2. On button click — receive webhook event with trigger_id
3. Open form immediately: pachca views open --type=modal --trigger-id=<trigger_id> --title="Request" --blocks='[...]'

   trigger_id expires in 3 seconds — prepare form object in advance

4. On form submit — receive webhook, process data

Constraints

Rate Limits

• Message send/edit/delete: ~4 req/sec per chat (burst: 30/sec for 5s)
• Message read: ~10 req/sec
• Other endpoints: ~50 req/sec
• Webhooks: ~4 req/sec per webhook ID
• On 429 response, respect the Retry-After header.

Pagination

• Cursor-based (preferred): use limit (1–50) and cursor parameters. Response includes meta.paginate with next_page, prev_page, has_next, has_prev.
• Use has_next / has_prev to detect end of data. Use prev_page to poll for new records "above" the list.
• Search endpoints (/search/users, /search/chats, /search/messages) return only next_page and total.
• Offset-based (legacy): use per (1–50) and page parameters.

Permissions

• User management, tag management, and message deletion require an admin token.
• Audit events and data export require an owner token and Corporation pricing plan.
• Link preview (unfurling) requires a dedicated unfurling bot token with whitelisted domains.
• POST /direct_url is the only endpoint that does not require authentication.

Error Handling

• 400 — validation error
• 401 — missing or invalid token
• 403 — insufficient permissions
• 404 — resource not found
• 429 — rate limited (check Retry-After)

Error response body: { "errors": [{ "key": "field", "value": "description" }] }

Guides

Detailed documentation on specific topics is available at:

• Быстрый старт — Первый запрос к API Пачки за 5 минут: получение персонального токена, проверка авторизации и отправка сообщения через cURL, Postman или официальный CLI
• AI агенты — Как Пачка работает с AI-агентами: треды как единица работы, сквозные треды, готовые Agent Skills для 40+ агентов и примеры сценариев в чатах и задачах
• CLI — Официальный CLI для Pachca API: все методы API как команды терминала с автодополнением, типизированными флагами и интерактивными подсказками. Node.js 20+
• SDK: Обзор — Типизированные SDK для Pachca API на TypeScript, Python, Go, Kotlin, Swift и C#: автодополнение, retry и пагинация. Или свой клиент через OpenAPI-генератор
• SDK: TypeScript — Типизированный клиент для Pachca API на TypeScript: Node.js 18+ или любое окружение с fetch. Автодополнение, автопагинация и retry. npm-пакет @pachca/sdk
• SDK: Python — Асинхронный типизированный клиент для Pachca API на Python: httpx, type hints, dataclass-модели, автопагинация и retry. PyPI-пакет, требуется Python 3.10+
• SDK: Go — Типизированный клиент для Pachca API на Go: синхронный, с context.Context, автопагинацией и обработкой retry. Установка через go get, требуется Go 1.24+
• SDK: Kotlin — Типизированный клиент для Pachca API на Kotlin: Ktor с корутинами, kotlinx.serialization и встроенным retry. JitPack, требуется Kotlin 2.2+ и Java 11+
• SDK: Swift — Типизированный клиент для Pachca API на Swift: URLSession, async throws, Codable и встроенный retry. Swift Package, Swift 5.9+, macOS 13+ или iOS 16+
• SDK: C# — Типизированный клиент для Pachca API на C#: .NET 8+ с async/await, CancellationToken, автопагинацией и обработкой retry. NuGet-пакет Pachca.Sdk
• Сценарии — Пошаговые сценарии для типичных задач с API Пачки: какие методы вызывать и в каком порядке. Основа Agent Skills для AI-агентов и команды pachca guide в CLI
• Боты — Боты в Пачке: создание, настройка токена и скоупов, ограничения в мобильных приложениях, работа с входящими и исходящими вебхуками, кнопками и формами
• Входящие вебхуки — Входящие вебхуки в Пачке: отправка сообщений от имени бота одним HTTP POST без API, шаблонизатор для форматирования, интеграции с CI/CD и мониторингом
• Исходящие вебхуки — Исходящие вебхуки в Пачке: уведомления о событиях пространства (сообщения, реакции, участники) в реальном времени, подпись для проверки подлинности запроса
• Кнопки в сообщениях — Интерактивные кнопки в сообщениях ботов Пачки: ссылки и действия, обработка нажатий через исходящий вебхук, открытие форм и переходы на внешние ресурсы
• Формы: Обзор — Модальные формы ботов в Пачке: поля ввода, списки, даты и кнопки, жизненный цикл представления — от нажатия кнопки до валидации и закрытия модального окна
• Формы: Блоки представления — 10 типов блоков представлений в формах ботов Пачки: заголовок, текст, поля ввода, выбор из списка, дата, кнопки. До 100 блоков в одном представлении
• Формы: Обработка форм — Обработка форм в Пачке: открытие представлений по trigger_id (3 секунды), приём результатов через исходящий вебхук, валидация полей и отображение ошибок
• Разворачивание ссылок — Unfurl в Пачке: превью ссылок внутренних сервисов прямо в чатах — бот ловит URL, подтягивает заголовок, описание, изображение и отправляет обратно в чат
• Экспорт сообщений — Экспорт сообщений из чатов Пачки: запрос архива за период до 45 дней, скачивание JSON-файлов, структура архива и ограничения по чатам. Тариф «Корпорация»
• DLP-система — DLP-система Пачки для защиты от утечек конфиденциальной информации: правила с условиями и действиями, приоритеты, контексты применения. Тариф «Корпорация»
• Журнал аудита событий — Журнал аудита событий Пачки для команд безопасности: типы событий, фильтрация по пользователю, периоду и типу, 90 дней хранения. Тариф «Корпорация»
• n8n: Обзор — Расширение Пачки для n8n со статусом verified by n8n: 18 ресурсов, триггер событий и AI-агент. Визуальные workflow без кода для CRM, CI/CD и уведомлений
• n8n: Начало работы — Установка расширения Пачки для n8n из официальной витрины: верифицированная нода, установка через Nodes panel, n8n Cloud и self-hosted, настройка Credentials и первый workflow
• n8n: Ресурсы и операции — 18 ресурсов и более 60 операций расширения Пачки для n8n: сообщения, чаты, задачи, сотрудники, боты, теги и вебхуки в модели Resource → Operation
• n8n: Триггер — Триггер Pachca Trigger для n8n: 16 типов событий Пачки, автоматическая и ручная регистрация вебхука, проверка подписи запроса и IP-фильтр для безопасности
• n8n: Тестирование — Тестирование n8n-узлов Пачки: Listen for test event, Pin Data и Execute Step для экшн-узлов, защита webhook-слота бота и локальная разработка через туннель
• n8n: Примеры workflow — Готовые сценарии автоматизации Пачки в n8n: приветствие сотрудника, пересылка сообщений, задачи из обсуждений, согласование, мониторинг и заявки на отпуск
• n8n: Продвинутые функции — Продвинутые функции n8n-расширения Пачки: загрузка файлов через S3, интерактивные кнопки, формы, AI-агент, разворачивание ссылок и журнал безопасности
• n8n: Устранение ошибок — Частые ошибки при работе с Пачкой в n8n: неверный Access Token, 401 Unauthorized, 403 Forbidden, 429 Too Many Requests и проблемы с доставкой вебхука
• n8n: Миграция с v1 — Обновление расширения Пачки для n8n с v1 на v2: таблицы переименований, новые возможности и полная обратная совместимость для существующих workflow
• Albato — Интеграция Пачки с Albato: подключите более 250 сервисов без кода и получайте уведомления о событиях из Jira, CRM и других систем прямо в чатах и каналах
• Последние обновления — История изменений API Пачки, CLI, SDK и расширения для n8n. Новые методы, параметры и возможности. RSS-лента и markdown-версия для AI-агентов и интеграций
• Основы API: Авторизация — Авторизация в API Пачки: персональный токен и токен бота, скоупы методов, настройка доступа для администраторов и сотрудников, смена владельца пространства
• Основы API: Запросы и ответы — Формат запросов и ответов API Пачки: базовый URL, заголовки Authorization и Content-Type, структура JSON-тела, коллекции Postman и Bruno для тестирования
• Основы API: Пагинация — Пагинация в API Пачки по курсору: две группы методов (списочные и поиск) с разной структурой meta, поля next_page, prev_page, has_next, has_prev, обход всех записей и polling новых данных через prev_page
• Основы API: Загрузка файлов — Трёхшаговая загрузка файлов в API Пачки через presigned URL S3: получение подписи, отправка multipart/form-data и прикрепление к сообщению или задаче
• Основы API: Ошибки и лимиты — Коды ошибок HTTP в API Пачки, структуры ApiError и OAuthError, лимиты rate limits по пользователям и ботам, обработка ответа 429 и заголовка Retry-After
• Основы API: Модели — Справочник моделей данных Pachca API: свойства и методы, возвращающие каждый объект — сотрудники, чаты, сообщения, задачи, теги, вебхуки и другие сущности

Modular Skills

For AI agents that support modular skills, install specialized skills for better context efficiency:

npx skills add pachca/openapi

Skill	Description
pachca-profile	Pachca — МОЙ профиль, МОЙ статус, МОЙ токен, кастомные поля
pachca-users	Pachca — управление сотрудниками (участниками пространства) и тегами (группами)
pachca-chats	Pachca — управление чатами, каналами и беседами
pachca-messages	Pachca — сообщения: отправка, редактирование, удаление
pachca-bots	Pachca — управление ботами, вебхуки и превью ссылок
pachca-forms	Pachca — интерактивные формы и модальные окна для ботов
pachca-tasks	Pachca — задачи и напоминания: создание, список, обновление, выполнение, удаление
pachca-search	Pachca — полнотекстовый поиск по сотрудникам, чатам и сообщениям
pachca-security	Pachca — журнал безопасности: отслеживание входов, действий пользователей, изменений сообщений и нарушений DLP

Skills index: https://dev.pachca.com/.well-known/skills/index.json