Skip to content

πŸ“ Forms

Surveys, questions, answers, publishing.

86 operations Β· CLI Β· MCP Β· Python

Sign in

You need Set
a token YANDEX_ID_OAUTH_TOKEN: a Yandex ID OAuth token; ycli auth login gets one. A ready IAM token in YANDEX_CLOUD_IAM_TOKEN works in its place
an organization YANDEX_ID_ORGANIZATION_ID (Yandex 360, sent as X-Org-Id) or YANDEX_CLOUD_ORGANIZATION_ID (Yandex Cloud, sent as X-Cloud-Org-Id)

How to get each of them: Authenticate.

Typical tasks

List your forms

ycli forms surveys list

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

forms.surveys.list(limit=500)

Read a form

ycli forms surveys get 686d0a1b2c3d4e5f00000001

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

forms.surveys.get("686d0a1b2c3d4e5f00000001")

Read the answers

ycli forms answers list 686d0a1b2c3d4e5f00000030

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

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

Export the answers

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))

Reference