pmlyДокументация
Открыть pmly

Быстрый старт REST API

Получите токен, узнайте идентификаторы пространства и команды, затем создайте и измените задачу.

Получение токена

  1. Войдите в pmly через email-код или Яндекс ID и выберите пространство.
  2. Откройте «Настройки → API-токены». Для этого примера выберите workspace:read, issues:read и issues:write.
  3. Создайте токен и сохраните секрет: он показывается только один раз.

Примеры рассчитаны на shell с синтаксисом sh. Подставьте свой токен в переменную окружения; не сохраняйте секрет в Git или URL.

Переменные окружения
export PMLY_API="https://app.pmly.ru/api/public/v1"
export PMLY_API_TOKEN="<ваш токен>"

Первый запрос

Пример запроса
curl "$PMLY_API/context" \
  --header "Authorization: Bearer $PMLY_API_TOKEN"

Ответ содержит user, workspace, scopes и expiresAt. Сохраните workspace.id:

Идентификатор пространства
export WORKSPACE_ID="<workspace.id из ответа>"
curl "$PMLY_API/workspaces/$WORKSPACE_ID/teams" \
  --header "Authorization: Bearer $PMLY_API_TOKEN"
curl "$PMLY_API/workspaces/$WORKSPACE_ID/statuses" \
  --header "Authorization: Bearer $PMLY_API_TOKEN"

Коллекции содержат items, total, limit и offset. Возьмите id нужной команды из items. Статус при создании можно не передавать: сервер выберет начальный статус команды.

Создание задачи

Выберите новый ключ для каждой новой задачи. Если ответ потерялся, повторите тот же запрос с тем же ключом.

Пример запроса
export TEAM_ID="<id команды>"
export IDEMPOTENCY_KEY="first-issue-2026-09-30-001"
curl --request POST "$PMLY_API/workspaces/$WORKSPACE_ID/issues" \
  --header "Authorization: Bearer $PMLY_API_TOKEN" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data "{\"teamId\":\"$TEAM_ID\",\"title\":\"Первая задача через API\"}"

Сервер вернёт 201 и задачу с id и version. Для проверки прочитайте её отдельным запросом:

Пример запроса
export ISSUE_ID="<id созданной задачи>"
curl "$PMLY_API/workspaces/$WORKSPACE_ID/issues/$ISSUE_ID" \
  --header "Authorization: Bearer $PMLY_API_TOKEN"

Изменение задачи

Используйте актуальную version из последнего GET. PATCH сохраняет поля, которые вы не передали.

Пример запроса
export VERSION="<version из GET>"
curl --request PATCH "$PMLY_API/workspaces/$WORKSPACE_ID/issues/$ISSUE_ID" \
  --header "Authorization: Bearer $PMLY_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data "{\"version\":$VERSION,\"priority\":2}"

При 409 прочитайте задачу заново и решите, какие изменения применить. Не повторяйте запись автоматически с новой версией.

Дальше: справочник методов и правила API.