BRIFLY
Войти

Убрать сценарий разговора в архив

Прячет скрипт из рабочего списка, не стирая. Нужен, когда по нему пока не звоните.

Прячет скрипт из рабочего списка, не стирая. Нужен, когда по нему пока не звоните.

Scope

scenarios:write

Заголовки

  • Content-Type: application/json
  • X-Api-Key — ключ проекта
  • Idempotency-Key — для повторного запроса с тем же результатом

Убрать сценарий разговора в архив

POST /v1/scenarios/archive. Scope scenarios:write.

Учебный пример магазина «Северная полка». Это не запись из вашей базы. Здесь сценарий: запрос и ответ на одном вызове.

Запрос

{
  "data": {
    "projectId": "11111111-1111-4111-8111-111111111111",
    "id": "9b9b9b9b-9b9b-49b9-89b9-9b9b9b9b9b9b"
  }
}

Ответ (успех, 200)

{
  "success": true,
  "data": {
    "id": "9b9b9b9b-9b9b-49b9-89b9-9b9b9b9b9b9b",
    "name": "Вопрос про кружку",
    "description": "Клиент спрашивает объём, бот отвечает и даёт ссылку.",
    "status": "draft",
    "enabled": false,
    "projectId": "11111111-1111-4111-8111-111111111111",
    "createdAt": "2026-10-16T09:00:00.000Z",
    "updatedAt": "2026-10-16T09:12:00.000Z",
    "deletedAt": null,
    "archivedAt": "2026-10-16T09:12:00.000Z"
  }
}

Пример cURL

curl -X POST "https://api-external.brifly.online/v1/scenarios/archive" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: {{api_key}}" \
  -d '{"data": {"projectId": "11111111-1111-4111-8111-111111111111", "id": "9b9b9b9b-9b9b-49b9-89b9-9b9b9b9b9b9b"}}'

Ошибки

  • 401 INVALID_API_KEY — нет ключа или ключ отозван.
  • 403 FORBIDDEN_SCOPE — у ключа нет scenarios:write.
  • 403 PROJECT_MISMATCH — в теле другой проект.
  • 429 RATE_LIMIT_EXCEEDED — заголовок Retry-After.
  • 400 VALIDATION_ERROR — не хватает поля в data.

Ограничения

  • Проект и пользователь берутся из ключа. Чужой data.projectId отвечает 403 PROJECT_MISMATCH.

См. также

Оцените статью — нам важна ваша обратная связь.

0 (0 оценок)