API reference

Ask a follow-up

Asks one follow-up round on a completed request, to all experts or selected ones.

POSThttps://api.synquery.com/v0/questions/{request_id}/follow-up

Authentication: send your API key in the x-api-key header.

Sends a follow-up question to experts who answered a completed request. This starts work that takes time: the round completes when every asked expert has answered or its deadline passes. Experts who don't answer are listed in warnings.

Follow-up answers are free text, not answer fields. Read them under follow_ups in Get status and answers, or wait for the followup.completed webhook.

Path parameters

request_idstringRequired#

A completed request.

Body

questionstringRequired#

The follow-up question.

respondent_idsarrayOptional#

Experts to ask. Default: all who answered.

deadlinestringOptional#

When to stop waiting (ISO 8601). Default: 48 hours after the follow-up is accepted.

Returns

follow_up_idstring#

ID of the round.

statusstring#

pending, then complete or failed.

submitted_at / deadlinestring#

When the round was accepted, and when it stops waiting.

In follow_ups[] on the request

responsesarray#

One per expert: respondent_id, answer, quote, received_at and confirmed_at.

One round per request

One follow-up round is included with every request. A second follow-up returns 409 follow_up_used.

Delete a request →

curl -X POST https://api.synquery.com/v0/questions/q_8f2k1x/follow-up \ -H "x-api-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"question": "Is the share different for revision knees, or only primary?", "respondent_ids": ["exp_4k9a2"]}'

{ "follow_ups": [ { "follow_up_id": "f_2p9d", "status": "complete", "question": "Is the share different for revision knees, or only primary?", "deadline": "2026-10-30T10:05:00Z", "responses": [ { "respondent_id": "exp_4k9a2", "answer": "Lower for revisions. Most of our revision cases are still done manually.", "quote": "Revisions are where we still go manual most of the time.", "received_at": "2026-10-28T16:20:00Z", "confirmed_at": "2026-10-28T16:31:00Z" } ] } ] }