Create an elicitation request

Returns immediately with an event_id; poll the result endpoint by it for the answers.

Authentication

AuthorizationBearer

Organization-scoped API key.

Headers

X-API-VersionstringRequired
Idempotency-KeystringRequired

Idempotency key; duplicate submissions return the original event.

Request

This endpoint expects an object.
fieldslist of objectsRequired
projectNamestringRequired>=1 character
summarystringRequired>=1 character

Human-readable summary of what’s needed

taskIdstringRequired

Target task — create one via POST /tasks first

attachmentslist of stringsOptional

Upload ids of attached files to render for this request (must already be attached to the task)

externalTraceIdstringOptional
keyValueContextmap from strings to stringsOptional
recommendationlist of objectsOptional

Response

Created