Ahora
Начать бесплатно

API для задач — чтобы заявки из других систем сами попадали на доску

Лид из CRM, заявка с сайта или алерт мониторинга становится задачей с исполнителем и сроком. Команда видит её на доске сразу, а ваш скрипт может следить за статусом и писать в комментарии.

Начать бесплатно Документация

Есть на всех тарифах, включая бесплатный. Токен создаётся в настройках воркспейса за минуту.

Задача из любой системы

Один POST-запрос — и на доске появляется задача с описанием, приоритетом, сроком, тегами и исполнителями. Все, кто смотрит доску, видят новую карточку сразу, без обновления страницы.

Исполнитель получает уведомление, как если бы задачу назначил коллега.

Запрос
curl https://ahora.team/api/v1/tasks \
  -H "Authorization: Bearer $AHORA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "boardId": "01JB6Y0M4Q…",
    "title": "Перезвонить клиенту",
    "priority": "high",
    "dueAt": "2026-10-21T12:00:00+03:00",
    "tags": ["crm"]
  }'

Без дублей, даже если запрос ушёл дважды

Сеть оборвалась, и интеграция повторила запрос? С заголовком Idempotency-Key Ahora вернёт уже созданную задачу, а не сделает вторую.

А по своему externalId — номеру лида или заявки — интеграция всегда найдёт «свою» задачу.

  • Idempotency-Key

    Повтор с тем же ключом в течение суток возвращает первый результат.

  • externalId

    Ваш идентификатор хранится рядом с задачей и не может повториться.

Ответ 201
{
  "data": {
    "id": "01JB7C2W9E…",
    "key": "TEAM-142",
    "title": "Перезвонить клиенту",
    "priority": "high",
    "externalId": "lead-92831",
    "version": 1
  }
}

Синхронизация в обе стороны

Забирайте задачи, изменившиеся с прошлого запуска, и обновляйте у себя статусы. Фильтры по доске, статусу, исполнителю, приоритету и срокам, постраничная выдача курсором.

Две системы не перезапишут правки друг друга: передайте версию задачи в If-Match, и если её уже кто-то поменял, сервер ответит 412, а не затрёт изменения.

Что изменилось с последней синхронизации
curl "https://ahora.team/api/v1/tasks?updatedAfter=2026-10-19T09:00:00Z&limit=100" \
  -H "Authorization: Bearer $AHORA_TOKEN"

Токены под контролем

Каждый участник создаёт личный токен в «Настройки → API и интеграции»: только чтение или чтение и изменение, на 30, 90 дней, год или без срока. Секрет показывается один раз, Ahora хранит только его хеш.

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

Кто я и что мне можно
curl https://ahora.team/api/v1/context \
  -H "Authorization: Bearer $AHORA_TOKEN"

{
  "workspace": { "name": "Тропа", "slug": "team" },
  "actor": { "name": "Анна Смирнова" },
  "scopes": ["tasks:read", "tasks:write"]
}

Ещё в API

  • Комментарии

    Интеграция может оставить комментарий или ответить в ветке — например, приложить статус оплаты.

  • Чек-листы

    Добавляйте пункты и отмечайте выполненные.

  • Исполнители

    Назначайте и снимайте исполнителей по одному.

  • Как действия человека

    Смена статуса, комментарий или назначение из API попадают в ленту задачи и в уведомления — от имени владельца токена.

  • Понятные ошибки

    У каждой ошибки есть машинный код, текст на русском и requestId запроса.

  • Тот же домен

    API работает на ahora.team, отдельных адресов и сертификатов не нужно.

Чего в API нет

  • Вебхуков — Ahora не присылает события сама, изменения нужно забирать запросом
  • Готовых интеграций с CRM, формами и Zapier — запросы пишете вы или ваш разработчик
  • Управления досками и статусами — их создают в приложении
  • Удаления задач — только перенос в архив
  • Чатов, базы знаний и файлов — API пока только для задач
  • SDK и OAuth-приложений — только HTTP-запросы с личным токеном

API в Ahora — для своих небольших интеграций: завести задачу из формы, подтянуть статусы в отчёт, оставить комментарий из скрипта.

Сколько стоит

API входит во все тарифы и ничего не стоит отдельно. Для команд до 15 человек Ahora бесплатен, платные уровни — от 490 ₽ в месяц за весь воркспейс.

Все цены

Вопросы

API платный?

Нет. API есть на всех тарифах, включая бесплатный, и отдельно не оплачивается.

Кто может создать токен?

Любой участник воркспейса — для себя. Владелец видит все токены и может отозвать любой.

От чьего имени создаются задачи?

От имени владельца токена. Комментарии и изменения подписаны его именем.

Есть ли ограничение на число запросов?

300 запросов в минуту на токен. Если превысить, сервер ответит 429 и подскажет, через сколько повторить.

Можно ли вызывать API из браузера на своём сайте?

Нет. Токен — секрет уровня пароля, его место на сервере. Форму на сайте отправляйте на свой бэкенд, а он уже обращается к Ahora.

Будут ли вебхуки?

Пока нет. Чтобы узнать об изменениях, запрашивайте задачи с фильтром updatedAfter.

Что ещё есть в Ahora

Начать можно прямо сейчас

После регистрации у вас сразу появится воркспейс. Создайте доску и отправьте коллегам ссылку-приглашение.

Начать бесплатно