pachca-tasks

Original：🇺🇸 English
Translated

Create, get, update, and delete tasks (reminders). Use when: create task, list tasks, update task, mark task done, delete task.

3installs
Sourcepachca/openapi
Added on

NPX Install

npx skill4agent add pachca/openapi pachca-tasks

Tags

Translated version includes tags in frontmatter
cli-tooltask-managementreminder-automationpachcaproductivity-tool

SKILL.md Content

View Translation Comparison →

pachca-tasks

Quick start

Ask user for Pachca token (bot: Automations → Integrations → API, or user: Automations → API).
Run commands with 
npx @pachca/cli
and 
--token
flag:
npx @pachca/cli <command> --token $PACHCA_TOKEN
Or set 
PACHCA_TOKEN
for multiple commands:
export PACHCA_TOKEN=<token>
npx @pachca/cli <command>
Help: 
npx @pachca/cli --help
| Scenarios: 
npx @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 user has a saved profile — check status:
    npx @pachca/cli auth status
    If OK — use commands without 
    --token
    .
  2. If profile is not configured — ask for token and use 
    --token
    flag:
    npx @pachca/cli auth status --token $PACHCA_TOKEN
  3. If you don't know command parameters — run 
    pachca <command> --help
    .

Step-by-step scenarios

Create reminder

  1. Create task:
    bash
    pachca tasks create --kind=reminder --content="Позвонить клиенту" --due-at=<дата> --chat-id=<chat_id>
    chat_id
    to link to chat, 
    custom_properties
    for additional fields
custom_properties[].value
type is always string. Additional fields: GET /custom_properties?entity_type=Task.

Get list of upcoming tasks

  1. Get all tasks, filter by 
    status
    on client side:
    bash
    pachca tasks list --all
    status
    : 
    "undone"
    — not completed, 
    "done"
    — completed. API-side filtering not supported

Get task by ID

  1. Get task info:
    bash
    pachca tasks get <ID>

Mark task as completed

  1. Update task status:
    bash
    pachca tasks update <ID> --status=done

Update task (reschedule, change assignees)

  1. Update task fields:
    bash
    pachca tasks update <ID> --due-at=<дата> --priority=2 --performer-ids='[186,187]'
    performer_ids
    replaces entire list. 
    priority
    : 1 (normal), 2 (important), 3 (very important)

Delete task

  1. Delete task:
    bash
    pachca tasks delete <ID> --force
Deletion is irreversible. To just close — use PUT with 
"status": "done"
.

Create series of reminders

  1. Prepare list of dates (daily, weekly, etc.)
  2. For each date: create task:
    bash
    pachca tasks create --kind=reminder --content="Напоминание" --due-at=<дата>

Constraints and gotchas

  • Rate limit: ~50 req/sec. On 429 — wait and retry.
  • task.kind
    : allowed values — 
    call
    (Позвонить контакту), 
    meeting
    (Встреча), 
    reminder
    (Простое напоминание), 
    event
    (Событие), 
    email
    (Написать письмо)
  • task.status
    : allowed values — 
    done
    (Выполнено), 
    undone
    (Активно)
  • limit
    : max 50
  • Pagination: cursor-based (limit + cursor)

Endpoints

MethodPathDescription
POST/tasksНовое напоминание
GET/tasksСписок напоминаний
GET/tasks/{id}Информация о напоминании
PUT/tasks/{id}Редактирование напоминания
DELETE/tasks/{id}Удаление напоминания
If you don't know how to complete a task — read the corresponding file from references/ for step-by-step instructions.