pachca-users
Pachca — управление сотрудниками (участниками пространства) и тегами (группами). Используй, когда пользователь хочет вывести список сотрудников, создать, обновить, заблокировать или удалить сотрудника, установить статус другому сотруднику по ID, управлять тегами/группами, назначить теги или провести онбординг/оффбординг. НЕ для своего профиля или своего статуса (используй pachca-profile), НЕ для поиска сотрудника по имени (используй pachca-search). Use when: сотрудник, сотрудники, список сотрудников, создать сотрудника, заблокировать сотрудника, уволить сотрудника, тег, теги, группа сотрудников, добавить в тег, онбординг, оффбординг. NOT for: мой профиль, мой статус, найди сотрудника, найти сотрудника, кастомные поля, дополнительные поля, получить профиль, мой профиль, установить свой статус → pachca-profile, → pachca-chats, найти сообщение по тексту, полнотекстовый поиск → pachca-search.
How do I install this agent skill?
npx skills add https://github.com/pachca/openapi --skill pachca-usersIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill allows for management of Pachca users and groups using official vendor tools. While it follows secure practices for authentication, it processes data from the Pachca API, which introduces a minor potential for indirect prompt injection if that data contains malicious instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/2 files flagged
What does this agent skill do?
pachca-users
Quick start
Ask the user for a Pachca token (bot: the API tab of the bot in Integrations → Bots, user: Integrations → API).
Run commands via npx -y @pachca/cli with the --token flag:
npx -y @pachca/cli <command> --token $PACHCA_TOKEN
Or set the PACHCA_TOKEN environment variable:
export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>
Help: npx -y @pachca/cli --help | Workflows: npx -y @pachca/cli guide
After successful use, suggest installing CLI globally:
npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN
Before you start
-
If the user has a saved profile — check:
npx -y @pachca/cli auth statusIf OK — run commands without
--token. -
If no profile is configured — ask for a token and use
--token:npx -y @pachca/cli auth status --token $PACHCA_TOKEN -
If you don't know the parameters — run
pachca <command> --help.
Workflows
Получить сотрудника по ID
- Получи информацию о сотруднике:
pachca users get <ID>
Возвращает все поля, включая
custom_properties,user_status,list_tags.
Массовое создание сотрудников с тегами
-
Создай тег (если нужен):
pachca group-tags create --name="Backend" -
Для каждого сотрудника: создай аккаунт с тегами:
pachca users create --first-name="Иван" --last-name="Петров" --email="ivan@example.com" --list-tags='[{"name":"Backend"}]'Теги назначаются через поле
list_tagsв теле запроса -
Или обнови существующего:
pachca users update <ID> --list-tags='[{"name":"Backend"}]'
Создание доступно только администраторам и владельцам (не ботам). Нет отдельного эндпоинта "добавить юзера в тег". Бесплатное пространство отправляет не больше 50 писем-приглашений за сутки: сверх лимита
422с кодомdaily_invites_limit, время сброса — вpayload.reset_at. С--skip-email-notifyписьмо не уходит и в лимит не идёт.
Создать гостя в чат
-
Выбери активный чат, в который добавить гостя — узнай его ID:
pachca chats listЧат должен быть активным (не архивным) и принадлежать вашей компании. У токена должно быть право добавлять в него участников.
-
Создай гостя: роль
guestи ровно один чат в--chat-ids:pachca users create --email="guest@example.com" --role=guest --chat-ids='[12345]'Для роли
guestchat_idsобязателен и должен содержать ровно один чат. Нарушение (не передан, пусто, больше одного, чат не существует, архивный или нет прав) →400с элементомerrors, гдеkey—chat_ids.
Для остальных ролей
chat_idsопционален — можно сразу добавить в несколько чатов. Создание доступно только администраторам и владельцам (не ботам).
Найти сотрудника по имени или email
- Поиск по имени/email (частичное совпадение):
pachca users list --query=Иван
Пагинация cursor-based:
limitиcursorизmeta. Для точного email — перебери страницы.
Онбординг нового сотрудника
-
Создай аккаунт:
pachca users create --email="new@example.com" --first-name="Иван" --last-name="Петров" -
Добавь в нужные каналы:
pachca members add <chat_id> --member-ids='[<user_id>]' -
Отправь welcome-сообщение:
pachca messages create --entity-type=user --entity-id=<user_id> --content="Добро пожаловать!"
Шаг 1 требует токена администратора/владельца. Шаги 2-3 можно делать ботом.
Offboarding сотрудника
-
Заблокировать доступ:
pachca users update <ID> --suspended -
Опционально: удалить аккаунт полностью:
pachca users delete <ID> --force
Приостановка (
suspended) сохраняет данные, удаление — необратимо.
Получить всех сотрудников тега/департамента
-
Найди тег по названию, возьми
id:pachca group-tags list --names='["Backend"]'Фильтр
names— серверная фильтрация по названию тега -
Получи всех участников тега:
pachca group-tags list-users <tag_id> --all
Управление статусом сотрудника
-
Получить текущий статус:
pachca users get-status <user_id> -
Установить статус:
pachca users update-status <user_id> --emoji="🏖️" --title="В отпуске" --is-awayis_away: true— режим «Нет на месте».away_message— макс 1024 символа -
Удалить статус:
pachca users remove-status <user_id> --force
Загрузить аватар сотрудника
- Загрузи аватар сотруднику:
pachca users update-avatar <user_id> --file=<путь_к_файлу>Требует прав администратора. Файл передается в формате multipart/form-data
Удалить аватар сотрудника
- Удали аватар сотрудника:
pachca users remove-avatar <user_id> --forceТребует прав администратора
Limitations
- Rate limit: ~50 req/sec. On 429 — wait and retry.
group_tag.name: max 255 charactersuser.first_name: max 255 charactersuser.last_name: max 255 charactersuser.email: max 255 charactersuser.phone_number: max 255 charactersuser.nickname: max 255 charactersuser.department: max 255 charactersuser.role: allowed values —admin(Администратор),user(Сотрудник),multi_guest(Мульти-гость),guest(Гость)status.title: max 50 charactersstatus.away_message: max 1024 characterslimit: max 50- Pagination: cursor-based (limit + cursor)
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /group_tags | Новый тег |
| GET | /group_tags | Список тегов |
| GET | /group_tags/{id} | Информация о теге |
| PUT | /group_tags/{id} | Редактирование тега |
| DELETE | /group_tags/{id} | Удаление тега |
| GET | /group_tags/{id}/users | Список сотрудников тега |
| POST | /users | Новый сотрудник |
| GET | /users | Список сотрудников |
| GET | /users/{id} | Информация о сотруднике |
| PUT | /users/{id} | Редактирование сотрудника |
| DELETE | /users/{id} | Удаление сотрудника |
| PUT | /users/{user_id}/avatar | Загрузка аватара сотрудника |
| DELETE | /users/{user_id}/avatar | Удаление аватара сотрудника |
| GET | /users/{user_id}/status | Статус сотрудника |
| PUT | /users/{user_id}/status | Новый статус сотрудника |
| DELETE | /users/{user_id}/status | Удаление статуса сотрудника |
If unsure how to complete a task, read the corresponding file from references/.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/pachca/openapi/pachca-users">View pachca-users on skillZs</a>