Quickstart

This guide assumes you already have a Program API key. If not, create one first: Authentication.

1. Confirm the key works

export QUESTRA_API_KEY=qpk_live_...

curl https://api.program.questra.ai/v1/whoami \
  -H "Authorization: Bearer $QUESTRA_API_KEY"

You should see auth_method of api_key and a workspace_id. Use https://api.program.staging.questra.ai if the key was created in staging.

2. List surveys

curl https://api.program.questra.ai/v1/surveys \
  -H "Authorization: Bearer $QUESTRA_API_KEY"

The response includes a data array of surveys in that workspace (plus offset pagination).

3. Create a survey

curl https://api.program.questra.ai/v1/surveys \
  -H "Authorization: Bearer $QUESTRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "brand-tracker-2026",
    "name": "Brand tracker 2026"
  }'

slug is lowercase kebab-case and unique per workspace. A duplicate slug returns 409. Save data.id for file upload and programming.

API overview

Upload a questionnaire, start programming, and read content revisions.

Programming

Convert the questionnaire into platform-native survey source.

Live updates

Subscribe to workflow streams while a run is in progress.

Webhooks

Get notified when programming or content finishes.

Getting started

Workflows

Webhooks

1. Confirm the key works

2. List surveys

3. Create a survey

Next

API overview

Programming

Live updates

Webhooks

​1. Confirm the key works

​2. List surveys

​3. Create a survey

​Next

API overview

Programming

Live updates

Webhooks

1. Confirm the key works

2. List surveys

3. Create a survey

Next