Перейти к содержанию

📝 Формы

Опросы, вопросы, ответы, публикация.

операций: 86 · CLI · MCP · Python

Вход

Нужно Задайте
токен YANDEX_ID_OAUTH_TOKEN: OAuth-токен Яндекс ID, его получает ycli auth login. Вместо него подойдёт готовый IAM-токен в YANDEX_CLOUD_IAM_TOKEN
организация YANDEX_ID_ORGANIZATION_ID (Яндекс 360, уходит в заголовке X-Org-Id) или YANDEX_CLOUD_ORGANIZATION_ID (Yandex Cloud, уходит в заголовке X-Cloud-Org-Id)

Как получить каждое значение: Аутентификация.

Типовые задачи

Список ваших форм

ycli forms surveys list

{
  "name": "forms_surveys_list",
  "arguments": {}
}

forms.surveys.list(limit=500)

Прочитать форму

ycli forms surveys get 686d0a1b2c3d4e5f00000001

{
  "name": "forms_surveys_get",
  "arguments": {
    "survey_id": "686d0a1b2c3d4e5f00000001"
  }
}

forms.surveys.get("686d0a1b2c3d4e5f00000001")

Прочитать ответы

ycli forms answers list 686d0a1b2c3d4e5f00000030

{
  "name": "forms_answers_list",
  "arguments": {
    "survey_id": "686d0a1b2c3d4e5f00000030"
  }
}

forms.answers.list("686d0a1b2c3d4e5f00000030", limit=500)

Выгрузить ответы

ycli forms answers export 686d0a1b2c3d4e5f00000030 --format csv --upload disk --started-at 2026-01-01T00:00:00 --finished-at 2026-02-01T00:00:00 --pk 11 --pk 12 --column answer_short_text_1 --limit 30 --upload-files --no-wait

{
  "name": "forms_answers_export",
  "arguments": {
    "survey_id": "686d0a1b2c3d4e5f00000030",
    "body": {
      "format": "csv",
      "upload": "disk",
      "started_at": "2026-01-01T00:00:00",
      "finished_at": "2026-02-01T00:00:00",
      "pks": [
        11,
        12
      ],
      "columns": [
        "answer_short_text_1"
      ],
      "limit": 30,
      "upload_files": true
    }
  }
}

forms.answers.export("686d0a1b2c3d4e5f00000030", AnswerExport(format="csv", upload="disk", started_at="2026-01-01T00:00:00", finished_at="2026-02-01T00:00:00", pks=[11, 12], columns=["answer_short_text_1"], limit=30, upload_files=True))

Справочник