Start export

start_export Requires export:read

In Live mode, export completed participant interviews as CSV — transcripts and answers with the organisation's PII-redaction settings applied. Test-mode simulations cannot be exported. Returns a job handle; poll get_export_status, then download from GET /v1/api/exports/{job_id}/download. Pass a unique idempotency_key when you may retry after a timeout or dropped connection; retrying with the same key returns the first result instead of starting a second job.

Input

study_id

string <uuid> required

Study whose Live-mode participant interviews to export.

format

enum("csv")

Export format. Only 'csv' is supported today.

idempotency_key

string | null

Optional retry key, the MCP form of the REST Idempotency-Key header. Pass a new unique value (for example a UUID) with each new request, and send the same value again only when retrying that exact request because you did not see its result (a timeout or dropped connection). A retry then returns the first result instead of starting a second job. The same key with different arguments returns 409, as does a retry while the first call is still running. Keys are scoped to your organisation and this operation and kept for about 7 days. Omit it and every call runs.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "start_export",
    "arguments": {
      "study_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "format": "csv",
      "idempotency_key": null
    }
  }
}