Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.questra.ai/llms.txt

Use this file to discover all available pages before exploring further.

Organization events fire for activity that spans your entire organization — surveys being created or deleted, and survey status changes. Subscribe to these events when you want to react to survey-level state changes regardless of which survey triggered them.

​
survey.created

Fires when a new survey is created (via POST /surveys). 
{
  "event": "survey.created",
  "timestamp": "2025-04-01T10:00:00Z",
  "data": {
    "id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
    "slug": "q4-customer-satisfaction-study",
    "name": "Q4 Customer Satisfaction Study",
    "user_id": "user_abc123",
    "org_id": "c0c1c2c3-d4d5-4678-9abc-def012345678",
    "status": "pending",
    "target_platform": null,
    "created_at": "2025-04-01T10:00:00Z",
    "updated_at": "2025-04-01T10:00:00Z"
  }
}

​
survey.updated

Fires when a survey’s metadata or lifecycle state changes — including when status, target_platform, or platform_ir_last_pushed_at are updated. 
{
  "event": "survey.updated",
  "timestamp": "2025-04-01T10:04:12Z",
  "data": {
    "id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
    "slug": "q4-customer-satisfaction-study",
    "name": "Q4 Customer Satisfaction Study",
    "user_id": "user_abc123",
    "org_id": "c0c1c2c3-d4d5-4678-9abc-def012345678",
    "status": "reviewing",
    "target_platform": "decipher",
    "platform_ir_last_pushed_at": "2025-04-01T10:04:12Z",
    "created_at": "2025-04-01T10:00:00Z",
    "updated_at": "2025-04-01T10:04:12Z"
  }
}
FieldDescription
statusCurrent survey status: pending, programming, waiting_for_destination, compiling, reviewing, live, or closed
target_platformThe survey platform the IR will be delivered to: decipher, confirmit, qualtrics, or alchemer (null until set)
platform_ir_last_pushed_atISO timestamp of the most recent successful push to the connected integration (null if never pushed)

​
survey.deleted

Fires when a survey is permanently deleted. 
{
  "event": "survey.deleted",
  "timestamp": "2025-04-01T11:00:00Z",
  "data": {
    "id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890"
  }
}

​
programming.started

Fires when AI programming begins for a survey. This is emitted once per programming job (not on retries). 
{
  "event": "programming.started",
  "timestamp": "2025-04-01T10:00:10Z",
  "data": {
    "survey_id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
    "file_id": "b9c8d7e6-f5a4-4321-9876-543210fedcba"
  }
}

​
programming.finished

Fires when a programming job finishes — whether it succeeded, failed, or was cancelled. 
{
  "event": "programming.finished",
  "timestamp": "2025-04-01T10:02:34Z",
  "data": {
    "survey_id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
    "file_id": "b9c8d7e6-f5a4-4321-9876-543210fedcba",
    "status": "completed"
  }
}
statusMeaning
completedProgramming finished successfully — the survey is ready to convert and push
failedAn error occurred
cancelledThe job was manually cancelled
programming.finished with status: "completed" means the Questra IR is built. Conversion to the target platform format and the push to your integration happen as a subsequent step. Watch survey.updated with status: "reviewing" (or platform_ir_last_pushed_at becoming non-null) for the fully-pushed signal.