pachca-profile
Pachca — МОЙ профиль, МОЙ статус, кастомные поля. Всегда только про себя — без параметров, данные определяются по токену. Используй, когда пользователь хочет получить свой профиль, узнать кто он, установить или убрать свой статус, посмотреть свой email/отдел, или узнать какие кастомные/дополнительные поля существуют (custom_properties). Также для запросов «кто я», «мой аккаунт», «мой email». НЕ для управления другими сотрудниками, НЕ для изменения статуса другого сотрудника, НЕ для информации о токене и его скоупах (используй pachca-oauth). Use when: мой профиль, покажи профиль, мой статус, установить статус, убрать статус, кто я, мой email, мои данные, дополнительные поля, кастомные поля. NOT for: сотрудники, список сотрудников, создать сотрудника, статус сотрудника, → pachca-users, → pachca-oauth.
How do I install this agent skill?
npx skills add https://github.com/pachca/openapi --skill pachca-profileIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a command-line interface to interact with the Pachca API for managing user profiles and statuses. It uses official vendor tools and follows standard practices for CLI integrations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/2 files flagged
What does this agent skill do?
pachca-profile
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
Получить свой профиль
- Получи информацию о текущем пользователе:
pachca profile get
Возвращает
id,first_name,last_name,nickname,phone_number,department,title,role,suspended,invite_status,list_tags,custom_properties,user_status,bot,sso,created_at,last_activity_at,time_zone,image_url.
Проверить свой токен
- Получи информацию о токене: скоупы, дату создания, срок жизни:
pachca oauth token-info
Полезно для диагностики: какие скоупы доступны токену, когда он истекает.
Установить статус
- Установи статус:
pachca profile update-status --emoji="🏖️" --title="В отпуске" --is-away --away-message="Я в отпуске до 10 марта" --expires-at="2025-03-10T23:59:59.000Z"is_away: true— режим «Нет на месте».expires_at— автосброс (ISO-8601, UTC+0).away_message— макс 1024 символа
Сбросить статус
- Удали статус:
pachca profile delete-status --force
Получить кастомные поля профиля
-
Получи список дополнительных полей для сотрудников:
pachca custom-properties list --entity-type=UserДобавь
entity_type=Userдля фильтрации -
Получи профиль — в
custom_propertiesсодержатся значения полей:pachca profile get
Кастомные поля настраиваются администратором пространства.
Загрузить аватар профиля
- Загрузи аватар из файла:
pachca profile update-avatar --file=<путь_к_файлу>Файл изображения передается в формате multipart/form-data
Удалить аватар профиля
- Удали аватар:
pachca profile delete-avatar --force
Limitations
- Rate limit: ~50 req/sec. On 429 — wait and retry.
status.title: max 50 charactersstatus.away_message: max 1024 characters- Pagination: cursor-based (limit + cursor)
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /custom_properties | Список дополнительных полей |
| GET | /profile | Свой профиль |
| PUT | /profile/avatar | Загрузка своего аватара |
| DELETE | /profile/avatar | Удаление своего аватара |
| GET | /profile/status | Свой статус |
| PUT | /profile/status | Новый свой статус |
| DELETE | /profile/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-profile">View pachca-profile on skillZs</a>