skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
pachca/openapi88 installs

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-profile
view source ↗

Is 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

  1. If the user has a saved profile — check:

    npx -y @pachca/cli auth status
    

    If OK — run commands without --token.

  2. If no profile is configured — ask for a token and use --token:

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN
    
  3. If you don't know the parameters — run pachca <command> --help.

Workflows

Получить свой профиль

  1. Получи информацию о текущем пользователе:
    pachca profile get
    

Возвращает id, first_name, last_name, nickname, email, 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.

Проверить свой токен

  1. Получи информацию о токене: скоупы, дату создания, срок жизни:
    pachca oauth token-info
    

Полезно для диагностики: какие скоупы доступны токену, когда он истекает.

Установить статус

  1. Установи статус:
    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 символа

Сбросить статус

  1. Удали статус:
    pachca profile delete-status --force
    

Получить кастомные поля профиля

  1. Получи список дополнительных полей для сотрудников:

    pachca custom-properties list --entity-type=User
    

    Добавь entity_type=User для фильтрации

  2. Получи профиль — в custom_properties содержатся значения полей:

    pachca profile get
    

Кастомные поля настраиваются администратором пространства.

Загрузить аватар профиля

  1. Загрузи аватар из файла:
    pachca profile update-avatar --file=<путь_к_файлу>
    

    Файл изображения передается в формате multipart/form-data

Удалить аватар профиля

  1. Удали аватар:
    pachca profile delete-avatar --force
    

Limitations

  • Rate limit: ~50 req/sec. On 429 — wait and retry.
  • status.title: max 50 characters
  • status.away_message: max 1024 characters
  • Pagination: cursor-based (limit + cursor)

Endpoints

MethodPathDescription
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/.

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>