Playground

Playground

RfpResponse

/api/v1/rfp/responses

An answer to an RfpQuestion.

listgetcreateupdate

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
rfp_record_idstringID of the parent RfpRecord.
question_idstringID of the RfpQuestion this response answers (rfq-<uuid>).
textstringFinal answer text (human-edited or approved).
ai_draftstringOriginal LLM-generated draft, preserved for diff comparison.
human_editedbooleanTrue if a human has edited the AI draft.
citationsjsonRAG chunk citations supporting this response.
attachment_refsjsonMinIO keys for supporting documents attached to this response.
statusstringCurrent review status of the response.
word_countnumberWord count of the final text.
tokens_innumberLLM input token count for the generation call.
tokens_outnumberLLM output token count for the generation call.
model_usedstringLLM model identifier used for generation.
trace_idstringID of the coreiq Trace for the generation call (trc-<uuid>).
authored_bystringID of the last human author (usr-<uuid>).
reviewed_byjsonIDs of reviewers (usr-<uuid>).
reviewed_atdate-timeISO 8601 timestamp of the review.
approved_bystringID of the approver (usr-<uuid>).
approved_atdate-timeISO 8601 timestamp of approval.
commentsjsonInline review comment threads.
version_historyjsonAppend-only version history of the response text.
tagsjsonFree-form tags.
versionnumberOptimistic concurrency version counter.

API

client.rfp.responses.*
Loading manifest…