Skip to navigation

Update a question set

Update the name or description, and append a new draft version when questions, inputMapping or model is present. Fields left out of a new version carry over from the latest version. No existing version is changed, and the slug is fixed.

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.
descriptionstring or nullOptional
inputMappingmap from strings to strings or nullOptional
modelstring or nullOptional>=1 character
namestringOptional1-255 characters
questionsmap from strings to anyOptional

Judgment questions keyed by question id. Each is { type: "boolean" | "choice" | "score", instructions, criteria }. The id is never sent to the model, so instructions and criteria carry the meaning.

Response

Updated
questionSetobject
versionobject or null

The new draft version, or null for a metadata-only update.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error