Все REST-запросы и MCP-инструменты
Здесь перечислены все 103 публичных операций реестра. Сайт использует и внутренние маршруты; они не являются публичным API для клиентов. REST: https://api.signailist.com/v1. MCP: https://api.signailist.com/mcp.
OpenAPI · Подключение MCP · Промпты и сценарии · Приём и вебхуки
Как читать справочник
REST использует API-ключ одного workspace; MCP — OAuth-согласие. Все примеры требуют замены ID и заполнителей своими значениями. Секрет в SIGNAILIST_API_KEY должен поступать из вашего хранилища секретов. Для изменяющих запросов обязателен постоянный Idempotency-Key: повтор прежнего намерения использует прежний ключ и тело. GET не требует этого заголовка. Примеры — формы запросов, они не выполняются документацией.
Метка платного запуска отражает реестр, а не гарантирует бесплатное выполнение всей последующей цепочки. Включение расписания может запустить будущие платные этапы. Создание источника с автоматическим получением названия может потребовать run и платный запрос метаданных. Сначала проверяйте возможности, готовность и бюджет.
Таблица полей и сворачиваемая JSON Schema показывают фактическую схему публичной проверки. У операций с общей object-схемой дополнительные ограничения применяет общий обработчик: это не разрешение передавать произвольные поля. Для таких операций используйте описанные примеры сценариев; request.json нужно заполнить телом своей операции. Существующие write-поля не обязаны совпадать с полями строки в ответе списка. Не передавайте пользовательский workspaceId: пространство закреплено ключом. Исключение — проверяемое совпадение workspaceId внутри сохраняемого документа.
Курсоры возвращаются только указанными ниже постраничными операциями: items и nextCursor. billing_usage использует page/pageSize. list_webhooks возвращает до 100 подписок без курсора. Остальные ответы могут быть объектами, массивами или вложенными структурами; не считайте их универсальным списком.
Общие результаты и ошибки
200/201 означают ответ/создание, 202 — приём работы, 204 — успех без тела. Конкретный обработчик может вернуть 200 или 201 вместе с идентификатором очереди: это не доказательство готового результата. Сохраняйте ID и проверяйте задание, источник, дайджест или квитанцию доставки. Нет единого поля jobId для всех запусков.
{
"error": {
"code": "INSUFFICIENT_SCOPE",
"requestId": "REQUEST_ID",
"retryable": false
}
}
400 — неверный ввод; 401 — ключ/токен отсутствует, истёк или отозван; 402 — баланс/суточный лимит; 403 — права/workspace; 404 — объект/маршрут; 409 — конфликт версии/идемпотентности или неопределённый результат; 413 — размер; 429 — частота/параллельность, учитывай те Retry-After. Максимум 120 запросов в минуту на подключение, пять параллельных мутаций или платных этапов. OAuth использует собственные стандартные ошибки.
Каталог
| MCP | REST | Право | Платный запуск |
|---|---|---|---|
| author_overview | GET /v1/author/overview | read | Нет¹ |
| edit_telegram_publication | POST /v1/accounts/telegram/{id}/messages/edit | publish | Нет¹ |
| verify_telegram_publications | POST /v1/accounts/telegram/{id}/messages/check | read | Нет¹ |
| regenerate_author_version | POST /v1/author/editions/{id}/regenerate-version | run | Да |
| resume_author_edition | POST /v1/author/editions/{id}/resume | run | Да |
| check_telegram_channels | POST /v1/accounts/telegram/{id}/channels/check | configure | Нет¹ |
| sync_telegram_channels | POST /v1/accounts/telegram/{id}/channels/sync | configure | Нет¹ |
| list_content_catalogs | GET /v1/author/catalogs | read | Нет¹ |
| create_content_catalog | POST /v1/author/catalogs | configure | Нет¹ |
| get_content_catalog | GET /v1/author/catalogs/{id} | read | Нет¹ |
| sync_content_catalog | POST /v1/author/catalogs/{id}/sync | configure | Нет¹ |
| list_catalog_items | GET /v1/author/catalogs/{id}/items | read | Нет¹ |
| put_catalog_item | PUT /v1/author/catalogs/{id}/items | configure | Нет¹ |
| list_author_series | GET /v1/author/series | read | Нет¹ |
| create_author_series | POST /v1/author/series | configure | Нет¹ |
| get_author_series | GET /v1/author/series/{id} | read | Нет¹ |
| update_author_series | PUT /v1/author/series/{id} | configure | Нет¹ |
| set_author_automation | POST /v1/author/series/{id}/automation | configure | Нет¹ |
| trial_author_series | POST /v1/author/series/{id}/trial | run | Да |
| list_author_editions | GET /v1/author/series/{id}/editions | read | Нет¹ |
| get_author_edition | GET /v1/author/editions/{id} | read | Нет¹ |
| publish_author_edition | POST /v1/author/editions/{id}/publish | publish | Да |
| delete_source | DELETE /v1/sources/{id} | configure | Нет¹ |
| delete_template | DELETE /v1/templates/{id} | configure | Нет¹ |
| delete_schedule | DELETE /v1/schedules/{id} | configure | Нет¹ |
| list_publications | GET /v1/publications | read | Нет¹ |
| list_telegram_accounts | GET /v1/accounts/telegram | read | Нет¹ |
| get_source_topic_tracking | GET /v1/source-topic-tracking | read | Нет¹ |
| list_sources | GET /v1/sources | read | Нет¹ |
| create_source | POST /v1/sources | configure | Нет¹ |
| update_source | PATCH /v1/sources/{id} | configure | Нет¹ |
| collect_source | POST /v1/sources/{id}/collect | run | Да |
| prepare_source | POST /v1/sources/{id}/prepare | run | Да |
| track_source_topics | POST /v1/source-topic-tracking | configure | Нет¹ |
| source_status | GET /v1/sources/{id}/analysis-status | read | Нет¹ |
| source_materials | GET /v1/sources/{id}/materials | read | Нет¹ |
| source_results | GET /v1/sources/{id}/results | read | Нет¹ |
| list_topics | GET /v1/topics | read | Нет¹ |
| create_topic | POST /v1/topics | configure | Нет¹ |
| update_topic | PATCH /v1/topics/{id} | configure | Нет¹ |
| delete_topic | DELETE /v1/topics/{id} | configure | Нет¹ |
| list_templates | GET /v1/templates | read | Нет¹ |
| create_template | POST /v1/templates | configure | Нет¹ |
| update_template | PATCH /v1/templates/{id} | configure | Нет¹ |
| generate_template | POST /v1/templates/generate | run | Да |
| list_digests | GET /v1/digests | read | Нет¹ |
| digest_candidates | GET /v1/digest-candidates | read | Нет¹ |
| create_digest | POST /v1/digests | configure | Нет¹ |
| get_digest | GET /v1/digests/{id} | read | Нет¹ |
| update_digest | PATCH /v1/digests/{id} | configure | Нет¹ |
| generate_digest_text | POST /v1/digests/{id}/generate-text | run | Да |
| generate_digest_image | POST /v1/digests/{id}/generate-image | run | Да |
| score_material | POST /v1/materials/{id}/score | run | Да |
| get_document | GET /v1/digests/{id}/document | read | Нет¹ |
| save_document | PUT /v1/digests/{id}/document | configure | Нет¹ |
| approve_document | POST /v1/digests/{id}/approve | publish | Нет¹ |
| publish_document | POST /v1/digests/{id}/publish | publish | Да |
| list_connections | GET /v1/connections | read | Нет¹ |
| create_discord_connection | POST /v1/connections | publish | Нет¹ |
| revoke_connection | POST /v1/connections/{id}/revoke | publish | Нет¹ |
| list_targets | GET /v1/targets | read | Нет¹ |
| create_target | POST /v1/targets | publish | Нет¹ |
| update_target | PATCH /v1/targets/{id} | publish | Нет¹ |
| list_schedules | GET /v1/schedules | read | Нет¹ |
| create_schedule | POST /v1/schedules | configure | Нет¹ |
| update_schedule | PATCH /v1/schedules/{id} | publish | Нет¹ |
| enable_schedule | POST /v1/schedules/{id}/enable | publish | Нет¹ |
| pause_schedule | POST /v1/schedules/{id}/pause | configure | Нет¹ |
| trigger_schedule | POST /v1/schedules/{id}/trigger | publish | Да |
| list_candidates | GET /v1/publication-candidates | read | Нет¹ |
| approve_candidate | POST /v1/publication-candidates/{id}/approve | publish | Да |
| reject_candidate | POST /v1/publication-candidates/{id}/reject | publish | Нет¹ |
| get_delivery | GET /v1/deliveries/{id} | read | Нет¹ |
| retry_delivery | POST /v1/deliveries/{id}/retry | publish | Да |
| cancel_publication | POST /v1/publications/{id}/cancel | configure | Нет¹ |
| list_jobs | GET /v1/jobs | read | Нет¹ |
| cancel_job | POST /v1/jobs/{id}/cancel | configure | Нет¹ |
| list_assets | GET /v1/assets | read | Нет¹ |
| upload_asset | POST /v1/assets | run | Да |
| list_signals | GET /v1/signals | read | Нет¹ |
| create_signal | POST /v1/signals | configure | Нет¹ |
| update_signal | PATCH /v1/signals/{id} | configure | Нет¹ |
| enable_signal | POST /v1/signals/{id}/enable | run | Нет¹ |
| pause_signal | POST /v1/signals/{id}/pause | configure | Нет¹ |
| billing_summary | GET /v1/billing/summary | billing:read | Нет¹ |
| billing_usage | GET /v1/billing/usage | billing:read | Нет¹ |
| get_job | GET /v1/jobs/{id} | read | Нет¹ |
| list_models | GET /v1/models | read | Нет¹ |
| list_reservations | GET /v1/reservations | billing:read | Нет¹ |
| capabilities | GET /v1/capabilities | read | Нет¹ |
| create_external_source | POST /v1/external-sources | configure | Нет¹ |
| ingest_materials | POST /v1/external-sources/{id}/items | ingest | Нет¹ |
| budget | GET /v1/budget | billing:read | Нет¹ |
| estimate | POST /v1/estimates | billing:read | Нет¹ |
| get_integration | GET /v1/integration | read | Нет¹ |
| revoke_integration | POST /v1/integration/revoke | read | Нет¹ |
| create_webhook | POST /v1/webhooks | webhooks | Нет¹ |
| list_webhooks | GET /v1/webhooks | webhooks | Нет¹ |
| list_webhook_deliveries | GET /v1/webhooks/deliveries | webhooks | Нет¹ |
| rotate_webhook | POST /v1/webhooks/{id}/rotate | webhooks | Нет¹ |
| pause_webhook | POST /v1/webhooks/{id}/pause | webhooks | Нет¹ |
| resume_webhook | POST /v1/webhooks/{id}/resume | webhooks | Нет¹ |
| retry_webhook | POST /v1/webhooks/deliveries/{id}/retry | webhooks | Нет¹ |
¹ Последующие этапы могут быть платными; см. пояснение выше и биллинг.