Generate answers for a questionnaire | Comp AI API

Starts background answer generation for an already-parsed questionnaire and returns a run handle immediately. Poll GET /v1/questionnaire/:id until.

POST /v1/questionnaire/{id}/auto-answer

Generate answers for a questionnaire

cURL

curl --request POST \
  --url https://api.trycomp.ai/v1/questionnaire/{id}/auto-answer \
  --header 'X-API-Key: <api-key>'

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.trycomp.ai/v1/questionnaire/{id}/auto-answer', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/questionnaire/{id}/auto-answer"

headers = {"X-API-Key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

200

{
  "questionnaireId": "qst_6a179d26c4ad2c1c816ee16d",
  "runId": "run_cmpotsz153eac0ultc1ya87f5",
  "publicAccessToken": "pat_...",
  "status": "generating",
  "totalQuestions": 23,
  "answeredQuestions": 0,
  "message": "Generating answers for 23 questions. Poll GET /v1/questionnaire/qst_... until answeredQuestions reaches totalQuestions."
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Path Parameters

id · string · required

Response

200 - application/json

questionnaireId · string · required

The questionnaire whose answers are being generated.

Example:

"qst_6a179d26c4ad2c1c816ee16d"

runId · string · required

Background run identifier for the generation job (Trigger.dev run id).

Example:

"run_cmpotsz153eac0ultc1ya87f5"

publicAccessToken · string · required

Token for tracking the run via Trigger.dev realtime. Optional — MCP/agent clients should poll GET /v1/questionnaire/:id instead.

Example:

"pat_..."

status · string · required

Always 'generating' on a successful trigger. Poll GET /v1/questionnaire/:id; answers are ready once answeredQuestions equals totalQuestions.

Example:

"generating"

totalQuestions · number · required

Total number of questions in the questionnaire.

Example:

23

answeredQuestions · number · required

Questions already answered at the moment generation was triggered (answers without a value are (re)generated).

Example:

0

message · string · required

Human-readable summary of what to do next.

Example:

"Generating answers for 23 questions. Poll GET /v1/questionnaire/qst_... until answeredQuestions reaches totalQuestions."