Create a new question owned by the caller’s account.
The question is one of six types selected by the required question_type
discriminator (categorical, rating, number, free_text, form, or timestamp),
and each type carries its own configuration block; name and prompt
are required for every type. Questions are the reusable units that are grouped
into question sets and referenced by rubrics, so create them before assembling
a question set. The created question is scoped to the caller’s account and
records the creating identity. The question type and its configuration are set
at creation time and cannot be changed afterward through the update endpoint.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Scale AI","colors":{"primary":"#3f2e7b","light":"#ca62ff","dark":"#3f2e7b"},"logo":{"light":"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/light.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=46027042c16b373ac463148db5ad1d6b","dark":"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/dark.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=02733f39d684d796ec742853eabf0de5"},"favicon":"https://mintcdn.com/scalegp/1vQnbXFkjbQbcgd1/favicon.png?fit=max\u0026auto=format\u0026n=1vQnbXFkjbQbcgd1\u0026q=85\u0026s=f52c84ba46a7cca58551673616dabe9c","background":{"decoration":"windows"},"navbar":{"links":[],"primary":{"type":"button","label":"Platform","href":"https://app.sgp.scale.com/"}},"footer":{"socials":{"x":"https://x.com/scale_ai","facebook":"https://www.facebook.com/scaleapi","linkedin":"https://www.linkedin.com/company/scaleai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scalegp","hasAudioNarration":false,"actualSubdomain":"scalegp","customDomains":["docs.gp.scale.com"],"gitSource":{"type":"github","owner":"scaleapi","repo":"sgp-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aecf0ec6829c68a2fb0d3c8","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":235},{"language":"default","tag":"AgentOps API","count":141},{"language":"default","tag":"Guides","count":131},{"language":"default","tag":"Agentex API","count":97},{"language":"default","tag":"Evaluations","count":72},{"language":"default","tag":"Dex API","count":48},{"language":"default","tag":"Agents","count":44},{"language":"default","tag":"Evaluation Datasets","count":34},{"language":"default","tag":"Models","count":32},{"language":"default","tag":"Knowledge Bases","count":31}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@font-face{font-family:'Aeonik';src:url('https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2');font-weight:normal;font-style:normal;font-display:swap}h1,h2,h3{font-family:'aeonik';letter-spacing:normal!important}"}],"page":{"pagePath":"reference/v5/questions/create-a-question","slug":"/reference/v5/questions/create-a-question","pageMetadata":{"title":"Create a question","description":"Create a new question owned by the caller's account.\n\nThe question is one of six types selected by the required ``question_type``\ndiscriminator (categorical, rating, number, free_text, form, or timestamp),\nand each type carries its own ``configuration`` block; ``name`` and ``prompt``\nare required for every type. Questions are the reusable units that are grouped\ninto question sets and referenced by rubrics, so create them before assembling\na question set. The created question is scoped to the caller's account and\nrecords the creating identity. The question type and its configuration are set\nat creation time and cannot be changed afterward through the update endpoint.","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/questions","href":"/reference/v5/questions/create-a-question","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create a new question owned by the caller’s account.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The question is one of six types selected by the required \", _jsx(_components.code, {\n children: \"question_type\"\n }), \"\\ndiscriminator (categorical, rating, number, free_text, form, or timestamp),\\nand each type carries its own \", _jsx(_components.code, {\n children: \"configuration\"\n }), \" block; \", _jsx(_components.code, {\n children: \"name\"\n }), \" and \", _jsx(_components.code, {\n children: \"prompt\"\n }), \"\\nare required for every type. Questions are the reusable units that are grouped\\ninto question sets and referenced by rubrics, so create them before assembling\\na question set. The created question is scoped to the caller’s account and\\nrecords the creating identity. The question type and its configuration are set\\nat creation time and cannot be changed afterward through the update endpoint.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a question","description":"Create a new question owned by the caller's account.\n\nThe question is one of six types selected by the required ``question_type``\ndiscriminator (categorical, rating, number, free_text, form, or timestamp),\nand each type carries its own ``configuration`` block; ``name`` and ``prompt``\nare required for every type. Questions are the reusable units that are grouped\ninto question sets and referenced by rubrics, so create them before assembling\na question set. The created question is scoped to the caller's account and\nrecords the creating identity. The question type and its configuration are set\nat creation time and cannot be changed afterward through the update endpoint.","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/questions","href":"/reference/v5/questions/create-a-question","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Questions"],"summary":"Create a question","description":"Create a new question owned by the caller's account.\n\nThe question is one of six types selected by the required ``question_type``\ndiscriminator (categorical, rating, number, free_text, form, or timestamp),\nand each type carries its own ``configuration`` block; ``name`` and ``prompt``\nare required for every type. Questions are the reusable units that are grouped\ninto question sets and referenced by rubrics, so create them before assembling\na question set. The created question is scoped to the caller's account and\nrecords the creating identity. The question type and its configuration are set\nat creation time and cannot be changed afterward through the update endpoint.","operationId":"POST-V5-/v5/questions","security":["8c9d32d1-0615-4808-ad56-661af906298b"],"parameters":["9e3fec35-7423-4338-aebf-494f133142ca"],"requestBody":"e066d1d3-1005-4996-bb00-b387d26154cb","responses":{"200":"85d53d90-9b6f-4e92-bc9b-d37e4e4f3746","422":"1ec0c62c-601f-413f-9a75-c84569a8f9dc"},"method":"post","type":"path","servers":["53d4b40c-6ecb-41f0-8721-9b4723f67775"],"path":"/v5/questions","baseUrlOptions":["https://api.egp.scale.com"],"title":"Create a question","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9e3fec35-7423-4338-aebf-494f133142ca":{"name":"x-selected-account-id","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Account ID Header","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Account ID Header","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"CategoricalQuestionRequest","required":["name","prompt","configuration"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.0.prompt","typeLabel":"string"},"configuration":{"properties":{"choices":{"items":{"type":"string","uniqueKey":"oneOf.0.configuration.choices.items.[INDEX]","typeLabel":"string"},"type":"array","minItems":1,"title":"Choices","description":"Categorical answer choices (must contain at least one entry)","isRequired":true,"uniqueKey":"oneOf.0.configuration.choices","typeLabel":"string[]"},"multi":{"oneOf":[{"type":"boolean","title":"Multi","description":"Whether the question allows multiple answers.","uniqueKey":"oneOf.0.configuration.multi.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Multi","description":"Whether the question allows multiple answers.","uniqueKey":"oneOf.0.configuration.multi.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.configuration.multi","typeLabel":"boolean | null"},"dropdown":{"oneOf":[{"type":"boolean","title":"Dropdown","description":"Whether the question is displayed as a dropdown in the UI.","uniqueKey":"oneOf.0.configuration.dropdown.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Dropdown","description":"Whether the question is displayed as a dropdown in the UI.","uniqueKey":"oneOf.0.configuration.dropdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.configuration.dropdown","typeLabel":"boolean | null"}},"type":"object","required":["choices"],"title":"CategoricalQuestionConfiguration","isRequired":true,"uniqueKey":"oneOf.0.configuration","typeLabel":"CategoricalQuestionConfiguration · object"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.0.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.0.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.0.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.conditions","typeLabel":"Conditions · object[] | null"},"question_type":{"type":"string","const":"categorical","title":"Question Type","default":"categorical","uniqueKey":"oneOf.0.question_type","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"CategoricalQuestionRequest · object"},{"type":"object","title":"RatingQuestionRequest","required":["name","prompt","configuration"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.1.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.1.prompt","typeLabel":"string"},"configuration":{"properties":{"min_label":{"type":"string","title":"Min Label","description":"Label shown for the minimum rating","isRequired":true,"uniqueKey":"oneOf.1.configuration.min_label","typeLabel":"string"},"max_label":{"type":"string","title":"Max Label","description":"Label shown for the maximum rating","isRequired":true,"uniqueKey":"oneOf.1.configuration.max_label","typeLabel":"string"},"steps":{"type":"integer","minimum":1,"title":"Steps","description":"Number of discrete points on the scale (e.g., 5 for a 1–5 scale)","isRequired":true,"uniqueKey":"oneOf.1.configuration.steps","typeLabel":"integer"}},"type":"object","required":["min_label","max_label","steps"],"title":"RatingQuestionConfiguration","isRequired":true,"uniqueKey":"oneOf.1.configuration","typeLabel":"RatingQuestionConfiguration · object"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.1.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.1.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.1.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.conditions","typeLabel":"Conditions · object[] | null"},"question_type":{"type":"string","const":"rating","title":"Question Type","default":"rating","uniqueKey":"oneOf.1.question_type","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"RatingQuestionRequest · object"},{"type":"object","title":"NumberQuestionRequest","required":["name","prompt"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.2.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.2.prompt","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.2.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.2.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.2.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.conditions","typeLabel":"Conditions · object[] | null"},"question_type":{"type":"string","const":"number","title":"Question Type","default":"number","uniqueKey":"oneOf.2.question_type","typeLabel":"string"},"configuration":{"properties":{"min":{"oneOf":[{"type":"number","title":"Min","description":"Minimum value for the number","uniqueKey":"oneOf.2.configuration.min.oneOf.0","typeLabel":"number"},{"type":"null","title":"Min","description":"Minimum value for the number","uniqueKey":"oneOf.2.configuration.min.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.configuration.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","title":"Max","description":"Maximum value for the number","uniqueKey":"oneOf.2.configuration.max.oneOf.0","typeLabel":"number"},{"type":"null","title":"Max","description":"Maximum value for the number","uniqueKey":"oneOf.2.configuration.max.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.configuration.max","typeLabel":"number | null"}},"type":"object","title":"NumberQuestionConfiguration","uniqueKey":"oneOf.2.configuration","typeLabel":"NumberQuestionConfiguration · object"}},"uniqueKey":"oneOf.2","typeLabel":"NumberQuestionRequest · object"},{"type":"object","title":"FreeTextQuestionRequest","required":["name","prompt"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.3.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.3.prompt","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.3.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.3.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.3.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.3.conditions","typeLabel":"Conditions · object[] | null"},"question_type":{"type":"string","const":"free_text","title":"Question Type","default":"free_text","uniqueKey":"oneOf.3.question_type","typeLabel":"string"},"configuration":{"properties":{"min_length":{"type":"integer","minimum":0,"title":"Min Length","description":"Minimum characters required","default":50,"uniqueKey":"oneOf.3.configuration.min_length","typeLabel":"integer"},"max_length":{"type":"integer","minimum":1,"title":"Max Length","description":"Maximum characters allowed","default":1000,"uniqueKey":"oneOf.3.configuration.max_length","typeLabel":"integer"}},"type":"object","title":"FreeTextQuestionConfiguration","uniqueKey":"oneOf.3.configuration","typeLabel":"FreeTextQuestionConfiguration · object"}},"uniqueKey":"oneOf.3","typeLabel":"FreeTextQuestionRequest · object"},{"type":"object","title":"FormQuestionRequest","required":["name","prompt","configuration"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.4.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.4.prompt","typeLabel":"string"},"configuration":{"properties":{"form_schema":{"additionalProperties":true,"type":"object","title":"Form Schema","description":"The JSON schema of the desired form object","isRequired":true,"uniqueKey":"oneOf.4.configuration.form_schema","typeLabel":"Form Schema · object"}},"type":"object","required":["form_schema"],"title":"FormQuestionConfiguration","isRequired":true,"uniqueKey":"oneOf.4.configuration","typeLabel":"FormQuestionConfiguration · object"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.4.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.4.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.4.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.4.conditions","typeLabel":"Conditions · object[] | null"},"question_type":{"type":"string","const":"form","title":"Question Type","default":"form","uniqueKey":"oneOf.4.question_type","typeLabel":"string"}},"uniqueKey":"oneOf.4","typeLabel":"FormQuestionRequest · object"},{"type":"object","title":"TimestampQuestionRequest","required":["name","prompt"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.5.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.5.prompt","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.5.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.5.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.5.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.5.conditions","typeLabel":"Conditions · object[] | null"},"question_type":{"type":"string","const":"timestamp","title":"Question Type","default":"timestamp","uniqueKey":"oneOf.5.question_type","typeLabel":"string"},"configuration":{"properties":{"multi":{"type":"boolean","title":"Multi","description":"Whether to allow multiple timestamps","default":false,"uniqueKey":"oneOf.5.configuration.multi","typeLabel":"boolean"}},"type":"object","title":"TimestampQuestionConfiguration","uniqueKey":"oneOf.5.configuration","typeLabel":"TimestampQuestionConfiguration · object"}},"uniqueKey":"oneOf.5","typeLabel":"TimestampQuestionRequest · object"}],"uniqueKey":"","typeLabel":"CategoricalQuestionRequest · object | RatingQuestionRequest · object | NumberQuestionRequest · object | FreeTextQuestionRequest · object | FormQuestionRequest · object | TimestampQuestionRequest · object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","prompt":"\u003cstring>","configuration":{"choices":["\u003cstring>"],"multi":true,"dropdown":true},"conditions":[{}],"question_type":"categorical"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"85d53d90-9b6f-4e92-bc9b-d37e4e4f3746":{"description":"Successful Response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Question","required":["created_by","id","created_at","name","prompt","configuration"],"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the entity","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"created_by":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"oneOf.0.created_by.id","typeLabel":"string"},"type":{"type":"string","enum":["user","service_account"],"title":"IdentityType","isRequired":true,"uniqueKey":"oneOf.0.created_by.type","typeLabel":"enum\u003cstring>"},"object":{"type":"string","const":"identity","title":"Object","default":"identity","uniqueKey":"oneOf.0.created_by.object","typeLabel":"string"}},"type":"object","required":["id","type"],"title":"Identity","description":"The identity that created the entity.","isRequired":true,"uniqueKey":"oneOf.0.created_by","typeLabel":"Identity · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-timestamp when the entity was created","isRequired":true,"uniqueKey":"oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.0.prompt","typeLabel":"string"},"configuration":{"properties":{"choices":{"items":{"type":"string","uniqueKey":"oneOf.0.configuration.choices.items.[INDEX]","typeLabel":"string"},"type":"array","minItems":1,"title":"Choices","description":"Categorical answer choices (must contain at least one entry)","isRequired":true,"uniqueKey":"oneOf.0.configuration.choices","typeLabel":"string[]"},"multi":{"oneOf":[{"type":"boolean","title":"Multi","description":"Whether the question allows multiple answers.","uniqueKey":"oneOf.0.configuration.multi.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Multi","description":"Whether the question allows multiple answers.","uniqueKey":"oneOf.0.configuration.multi.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.configuration.multi","typeLabel":"boolean | null"},"dropdown":{"oneOf":[{"type":"boolean","title":"Dropdown","description":"Whether the question is displayed as a dropdown in the UI.","uniqueKey":"oneOf.0.configuration.dropdown.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Dropdown","description":"Whether the question is displayed as a dropdown in the UI.","uniqueKey":"oneOf.0.configuration.dropdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.configuration.dropdown","typeLabel":"boolean | null"}},"type":"object","required":["choices"],"title":"CategoricalQuestionConfiguration","isRequired":true,"uniqueKey":"oneOf.0.configuration","typeLabel":"CategoricalQuestionConfiguration · object"},"object":{"type":"string","const":"question","title":"Object","default":"question","uniqueKey":"oneOf.0.object","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.0.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.0.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.0.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.conditions","typeLabel":"Conditions · object[] | null"},"archived_at":{"oneOf":[{"type":"string","title":"Archived At","description":"ISO-timestamp when the entity was archived","format":"date-time","uniqueKey":"oneOf.0.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Archived At","description":"ISO-timestamp when the entity was archived","uniqueKey":"oneOf.0.archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.archived_at","typeLabel":"string\u003cdate-time> | null"},"question_type":{"type":"string","const":"categorical","title":"Question Type","default":"categorical","uniqueKey":"oneOf.0.question_type","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"Question · object"},{"type":"object","title":"Question","required":["created_by","id","created_at","name","prompt","configuration"],"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the entity","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"created_by":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"oneOf.1.created_by.id","typeLabel":"string"},"type":{"type":"string","enum":["user","service_account"],"title":"IdentityType","isRequired":true,"uniqueKey":"oneOf.1.created_by.type","typeLabel":"enum\u003cstring>"},"object":{"type":"string","const":"identity","title":"Object","default":"identity","uniqueKey":"oneOf.1.created_by.object","typeLabel":"string"}},"type":"object","required":["id","type"],"title":"Identity","description":"The identity that created the entity.","isRequired":true,"uniqueKey":"oneOf.1.created_by","typeLabel":"Identity · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-timestamp when the entity was created","isRequired":true,"uniqueKey":"oneOf.1.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.1.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.1.prompt","typeLabel":"string"},"configuration":{"properties":{"min_label":{"type":"string","title":"Min Label","description":"Label shown for the minimum rating","isRequired":true,"uniqueKey":"oneOf.1.configuration.min_label","typeLabel":"string"},"max_label":{"type":"string","title":"Max Label","description":"Label shown for the maximum rating","isRequired":true,"uniqueKey":"oneOf.1.configuration.max_label","typeLabel":"string"},"steps":{"type":"integer","minimum":1,"title":"Steps","description":"Number of discrete points on the scale (e.g., 5 for a 1–5 scale)","isRequired":true,"uniqueKey":"oneOf.1.configuration.steps","typeLabel":"integer"}},"type":"object","required":["min_label","max_label","steps"],"title":"RatingQuestionConfiguration","isRequired":true,"uniqueKey":"oneOf.1.configuration","typeLabel":"RatingQuestionConfiguration · object"},"object":{"type":"string","const":"question","title":"Object","default":"question","uniqueKey":"oneOf.1.object","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.1.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.1.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.1.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.conditions","typeLabel":"Conditions · object[] | null"},"archived_at":{"oneOf":[{"type":"string","title":"Archived At","description":"ISO-timestamp when the entity was archived","format":"date-time","uniqueKey":"oneOf.1.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Archived At","description":"ISO-timestamp when the entity was archived","uniqueKey":"oneOf.1.archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.archived_at","typeLabel":"string\u003cdate-time> | null"},"question_type":{"type":"string","const":"rating","title":"Question Type","default":"rating","uniqueKey":"oneOf.1.question_type","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"Question · object"},{"type":"object","title":"Question","required":["created_by","id","created_at","name","prompt"],"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the entity","isRequired":true,"uniqueKey":"oneOf.2.id","typeLabel":"string"},"created_by":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"oneOf.2.created_by.id","typeLabel":"string"},"type":{"type":"string","enum":["user","service_account"],"title":"IdentityType","isRequired":true,"uniqueKey":"oneOf.2.created_by.type","typeLabel":"enum\u003cstring>"},"object":{"type":"string","const":"identity","title":"Object","default":"identity","uniqueKey":"oneOf.2.created_by.object","typeLabel":"string"}},"type":"object","required":["id","type"],"title":"Identity","description":"The identity that created the entity.","isRequired":true,"uniqueKey":"oneOf.2.created_by","typeLabel":"Identity · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-timestamp when the entity was created","isRequired":true,"uniqueKey":"oneOf.2.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.2.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.2.prompt","typeLabel":"string"},"object":{"type":"string","const":"question","title":"Object","default":"question","uniqueKey":"oneOf.2.object","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.2.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.2.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.2.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.conditions","typeLabel":"Conditions · object[] | null"},"archived_at":{"oneOf":[{"type":"string","title":"Archived At","description":"ISO-timestamp when the entity was archived","format":"date-time","uniqueKey":"oneOf.2.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Archived At","description":"ISO-timestamp when the entity was archived","uniqueKey":"oneOf.2.archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.archived_at","typeLabel":"string\u003cdate-time> | null"},"question_type":{"type":"string","const":"number","title":"Question Type","default":"number","uniqueKey":"oneOf.2.question_type","typeLabel":"string"},"configuration":{"properties":{"min":{"oneOf":[{"type":"number","title":"Min","description":"Minimum value for the number","uniqueKey":"oneOf.2.configuration.min.oneOf.0","typeLabel":"number"},{"type":"null","title":"Min","description":"Minimum value for the number","uniqueKey":"oneOf.2.configuration.min.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.configuration.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","title":"Max","description":"Maximum value for the number","uniqueKey":"oneOf.2.configuration.max.oneOf.0","typeLabel":"number"},{"type":"null","title":"Max","description":"Maximum value for the number","uniqueKey":"oneOf.2.configuration.max.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.configuration.max","typeLabel":"number | null"}},"type":"object","title":"NumberQuestionConfiguration","uniqueKey":"oneOf.2.configuration","typeLabel":"NumberQuestionConfiguration · object"}},"uniqueKey":"oneOf.2","typeLabel":"Question · object"},{"type":"object","title":"Question","required":["created_by","id","created_at","name","prompt"],"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the entity","isRequired":true,"uniqueKey":"oneOf.3.id","typeLabel":"string"},"created_by":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"oneOf.3.created_by.id","typeLabel":"string"},"type":{"type":"string","enum":["user","service_account"],"title":"IdentityType","isRequired":true,"uniqueKey":"oneOf.3.created_by.type","typeLabel":"enum\u003cstring>"},"object":{"type":"string","const":"identity","title":"Object","default":"identity","uniqueKey":"oneOf.3.created_by.object","typeLabel":"string"}},"type":"object","required":["id","type"],"title":"Identity","description":"The identity that created the entity.","isRequired":true,"uniqueKey":"oneOf.3.created_by","typeLabel":"Identity · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-timestamp when the entity was created","isRequired":true,"uniqueKey":"oneOf.3.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.3.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.3.prompt","typeLabel":"string"},"object":{"type":"string","const":"question","title":"Object","default":"question","uniqueKey":"oneOf.3.object","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.3.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.3.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.3.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.3.conditions","typeLabel":"Conditions · object[] | null"},"archived_at":{"oneOf":[{"type":"string","title":"Archived At","description":"ISO-timestamp when the entity was archived","format":"date-time","uniqueKey":"oneOf.3.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Archived At","description":"ISO-timestamp when the entity was archived","uniqueKey":"oneOf.3.archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.3.archived_at","typeLabel":"string\u003cdate-time> | null"},"question_type":{"type":"string","const":"free_text","title":"Question Type","default":"free_text","uniqueKey":"oneOf.3.question_type","typeLabel":"string"},"configuration":{"properties":{"min_length":{"type":"integer","minimum":0,"title":"Min Length","description":"Minimum characters required","default":50,"uniqueKey":"oneOf.3.configuration.min_length","typeLabel":"integer"},"max_length":{"type":"integer","minimum":1,"title":"Max Length","description":"Maximum characters allowed","default":1000,"uniqueKey":"oneOf.3.configuration.max_length","typeLabel":"integer"}},"type":"object","title":"FreeTextQuestionConfiguration","uniqueKey":"oneOf.3.configuration","typeLabel":"FreeTextQuestionConfiguration · object"}},"uniqueKey":"oneOf.3","typeLabel":"Question · object"},{"type":"object","title":"Question","required":["created_by","id","created_at","name","prompt","configuration"],"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the entity","isRequired":true,"uniqueKey":"oneOf.4.id","typeLabel":"string"},"created_by":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"oneOf.4.created_by.id","typeLabel":"string"},"type":{"type":"string","enum":["user","service_account"],"title":"IdentityType","isRequired":true,"uniqueKey":"oneOf.4.created_by.type","typeLabel":"enum\u003cstring>"},"object":{"type":"string","const":"identity","title":"Object","default":"identity","uniqueKey":"oneOf.4.created_by.object","typeLabel":"string"}},"type":"object","required":["id","type"],"title":"Identity","description":"The identity that created the entity.","isRequired":true,"uniqueKey":"oneOf.4.created_by","typeLabel":"Identity · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-timestamp when the entity was created","isRequired":true,"uniqueKey":"oneOf.4.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.4.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.4.prompt","typeLabel":"string"},"configuration":{"properties":{"form_schema":{"additionalProperties":true,"type":"object","title":"Form Schema","description":"The JSON schema of the desired form object","isRequired":true,"uniqueKey":"oneOf.4.configuration.form_schema","typeLabel":"Form Schema · object"}},"type":"object","required":["form_schema"],"title":"FormQuestionConfiguration","isRequired":true,"uniqueKey":"oneOf.4.configuration","typeLabel":"FormQuestionConfiguration · object"},"object":{"type":"string","const":"question","title":"Object","default":"question","uniqueKey":"oneOf.4.object","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.4.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.4.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.4.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.4.conditions","typeLabel":"Conditions · object[] | null"},"archived_at":{"oneOf":[{"type":"string","title":"Archived At","description":"ISO-timestamp when the entity was archived","format":"date-time","uniqueKey":"oneOf.4.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Archived At","description":"ISO-timestamp when the entity was archived","uniqueKey":"oneOf.4.archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.4.archived_at","typeLabel":"string\u003cdate-time> | null"},"question_type":{"type":"string","const":"form","title":"Question Type","default":"form","uniqueKey":"oneOf.4.question_type","typeLabel":"string"}},"uniqueKey":"oneOf.4","typeLabel":"Question · object"},{"type":"object","title":"Question","required":["created_by","id","created_at","name","prompt"],"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the entity","isRequired":true,"uniqueKey":"oneOf.5.id","typeLabel":"string"},"created_by":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"oneOf.5.created_by.id","typeLabel":"string"},"type":{"type":"string","enum":["user","service_account"],"title":"IdentityType","isRequired":true,"uniqueKey":"oneOf.5.created_by.type","typeLabel":"enum\u003cstring>"},"object":{"type":"string","const":"identity","title":"Object","default":"identity","uniqueKey":"oneOf.5.created_by.object","typeLabel":"string"}},"type":"object","required":["id","type"],"title":"Identity","description":"The identity that created the entity.","isRequired":true,"uniqueKey":"oneOf.5.created_by","typeLabel":"Identity · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"ISO-timestamp when the entity was created","isRequired":true,"uniqueKey":"oneOf.5.created_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"oneOf.5.name","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"user-facing question prompt","isRequired":true,"uniqueKey":"oneOf.5.prompt","typeLabel":"string"},"object":{"type":"string","const":"question","title":"Object","default":"question","uniqueKey":"oneOf.5.object","typeLabel":"string"},"conditions":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"oneOf.5.conditions.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.5.conditions.oneOf.0","typeLabel":"Conditions · object[]"},{"type":"null","title":"Conditions","description":"Conditions for the question to be shown","uniqueKey":"oneOf.5.conditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.5.conditions","typeLabel":"Conditions · object[] | null"},"archived_at":{"oneOf":[{"type":"string","title":"Archived At","description":"ISO-timestamp when the entity was archived","format":"date-time","uniqueKey":"oneOf.5.archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Archived At","description":"ISO-timestamp when the entity was archived","uniqueKey":"oneOf.5.archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.5.archived_at","typeLabel":"string\u003cdate-time> | null"},"question_type":{"type":"string","const":"timestamp","title":"Question Type","default":"timestamp","uniqueKey":"oneOf.5.question_type","typeLabel":"string"},"configuration":{"properties":{"multi":{"type":"boolean","title":"Multi","description":"Whether to allow multiple timestamps","default":false,"uniqueKey":"oneOf.5.configuration.multi","typeLabel":"boolean"}},"type":"object","title":"TimestampQuestionConfiguration","uniqueKey":"oneOf.5.configuration","typeLabel":"TimestampQuestionConfiguration · object"}},"uniqueKey":"oneOf.5","typeLabel":"Question · object"}],"uniqueKey":"","typeLabel":"Question · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","created_by":{"id":"\u003cstring>","type":"user","object":"identity"},"created_at":"2023-11-07T05:31:56Z","name":"\u003cstring>","prompt":"\u003cstring>","configuration":{"choices":["\u003cstring>"],"multi":true,"dropdown":true},"object":"question","conditions":[{}],"archived_at":"2023-11-07T05:31:56Z","question_type":"categorical"}}},"exampleType":"generated"}},"exampleType":"generated"},"1ec0c62c-601f-413f-9a75-c84569a8f9dc":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","additionalProperties":true,"uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8c9d32d1-0615-4808-ad56-661af906298b":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"53d4b40c-6ecb-41f0-8721-9b4723f67775":{"url":"https://api.egp.scale.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"x-api-key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"openapi/v5.yaml"},"subdomain":"scalegp","siteName":"Scale AI","title":"Create a question - Scale AI","navMaps":{"firstHrefInVersion":{"V5":{"href":"/reference/v5/questions/create-a-question","matchLevel":0},"V4 (legacy)":{"href":"/reference/v4/questions/list-questions","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T19:56:25.153Z","originalFileLocation":"reference/v5/questions/create-a-question.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new question owned by the caller\u0026#x27;s account. The question is one of six types selected by the required question_type discriminator (categorical, rating, number, free_text, form, or timestamp), and each type carries its own configuration block; name and prompt are required for every type. Questions are the reusable units that are grouped into question sets and referenced by rubrics, so create them before assembling a question set. The created question is scoped to the caller\u0026#x27;s account and records the creating identity. The question type and its configuration are set at creation time and cannot be changed afterward through the update endpoint.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Scale AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a question - Scale AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new question owned by the caller\u0026#x27;s account. The question is one of six types selected by the required question_type discriminator (categorical, rating, number, free_text, form, or timestamp), and each type carries its own configuration block; name and prompt are required for every type. Questions are the reusable units that are grouped into question sets and referenced by rubrics, so create them before assembling a question set. The created question is scoped to the caller\u0026#x27;s account and records the creating identity. The question type and its configuration are set at creation time and cannot be changed afterward through the update endpoint.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Scale AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gp.scale.com/reference/v5/questions/create-a-question\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scalegp.mintlify.site/_mintlify/api/og/v2?division=Questions\u0026amp;title=Create+a+question\u0026amp;description=Create+a+new+question+owned+by+the+caller%27s+account.%0A%0AThe+question+is+one+of+six+types+selected+by+the+required+%60%60question_type%60%60%0Adiscriminator+%28categorical%2C+ra\u0026amp;theme=b7e87dd2f9a2a23155199f59\u0026amp;signature=080161924ce2bab58d49f3480263c98790b5cbe8b3302ae101a688093066ed89\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a question - Scale AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new question owned by the caller\u0026#x27;s account. The question is one of six types selected by the required question_type discriminator (categorical, rating, number, free_text, form, or timestamp), and each type carries its own configuration block; name and prompt are required for every type. Questions are the reusable units that are grouped into question sets and referenced by rubrics, so create them before assembling a question set. The created question is scoped to the caller\u0026#x27;s account and records the creating identity. The question type and its configuration are set at creation time and cannot be changed afterward through the update endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scalegp.mintlify.site/_mintlify/api/og/v2?division=Questions\u0026amp;title=Create+a+question\u0026amp;description=Create+a+new+question+owned+by+the+caller%27s+account.%0A%0AThe+question+is+one+of+six+types+selected+by+the+required+%60%60question_type%60%60%0Adiscriminator+%28categorical%2C+ra\u0026amp;theme=b7e87dd2f9a2a23155199f59\u0026amp;signature=080161924ce2bab58d49f3480263c98790b5cbe8b3302ae101a688093066ed89\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Scale AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3f2e7b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gp.scale.com/reference/v5/questions/create-a-question\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/v5/questions/create-a-question.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gp.scale.com/#organization\",\"name\":\"Scale AI\",\"url\":\"https://docs.gp.scale.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/light.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=46027042c16b373ac463148db5ad1d6b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gp.scale.com#website\",\"name\":\"Scale AI\",\"url\":\"https://docs.gp.scale.com\",\"publisher\":{\"@id\":\"https://docs.gp.scale.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question#webpage\",\"url\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question\",\"name\":\"Create a question\",\"description\":\"Create a new question owned by the caller's account. The question is one of six types selected by the required question_type discriminator (categorical, rating, number, free_text, form, or timestamp), and each type carries its own configuration block; name and prompt are required for every type. Questions are the reusable units that are grouped into question sets and referenced by rubrics, so create them before assembling a question set. The created question is scoped to the caller's account and records the creating identity. The question type and its configuration are set at creation time and cannot be changed afterward through the update endpoint.\",\"dateModified\":\"2026-09-28T19:56:25.153Z\",\"isPartOf\":{\"@id\":\"https://docs.gp.scale.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Questions\",\"item\":\"https://docs.gp.scale.com/reference/v5/questions/list-questions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a question\",\"item\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question#apireference\",\"headline\":\"Create a question\",\"name\":\"Create a question\",\"description\":\"Create a new question owned by the caller's account. The question is one of six types selected by the required question_type discriminator (categorical, rating, number, free_text, form, or timestamp), and each type carries its own configuration block; name and prompt are required for every type. Questions are the reusable units that are grouped into question sets and referenced by rubrics, so create them before assembling a question set. The created question is scoped to the caller's account and records the creating identity. The question type and its configuration are set at creation time and cannot be changed afterward through the update endpoint.\",\"url\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gp.scale.com/reference/v5/questions/create-a-question#webpage\"},\"dateModified\":\"2026-09-28T19:56:25.153Z\",\"publisher\":{\"@id\":\"https://docs.gp.scale.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gp.scale.com#website\"}}]}\u003c/script>","siteName":"Scale AI","nav":{"global":null,"versions":[{"version":"V5","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/v5/overview"}]},{"tab":"AgentOps API","groups":[{"group":"Inference","pages":[{"title":"Run inference with free-form payload","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/inference","href":"/reference/v5/inference/run-inference-with-free-form-payload"},{"title":"Generate OpenAI chat completion from messages","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/chat/completions","href":"/reference/v5/inference/generate-openai-chat-completion-from-messages"},{"title":"Run OpenAI Responses API (OpenAI only)","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/responses","href":"/reference/v5/inference/run-openai-responses-api-openai-only"},{"title":"Generate legacy text completion from prompt","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/completions","href":"/reference/v5/inference/generate-legacy-text-completion-from-prompt"},{"title":"List available chat completion models","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/chat/completions/models","href":"/reference/v5/inference/list-available-chat-completion-models"}]},{"group":"Questions","pages":[{"title":"List questions","description":"Return a paginated list of the caller's account's questions.\n\nArchived questions are excluded by default; set ``include_archived`` to true\nto include them alongside active ones. Pass ``ids`` to restrict the result to\na specific set of question IDs. Results are paginated through the standard\npagination parameters. Use this to discover existing questions before adding\nthem to a question set, or to audit which questions have been archived.","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/questions","href":"/reference/v5/questions/list-questions"},{"title":"Create a question","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/questions","href":"/reference/v5/questions/create-a-question"},{"title":"Get a question","description":"Retrieve a single question in the caller's account by its ID.\n\nBoth active and archived questions are returned; the archived state is\nconveyed by the ``archived_at`` field on the response. The lookup is scoped to\nthe caller's account, and a question that does not exist within that account\nresults in a not-found error.","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/questions/{question_id}","href":"/reference/v5/questions/get-a-question"},{"title":"Archive a question","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/questions/{question_id}","href":"/reference/v5/questions/archive-a-question"},{"title":"Update a question","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/questions/{question_id}","href":"/reference/v5/questions/update-a-question"},{"title":"Restore an archived question","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/questions/{question_id}/restore","href":"/reference/v5/questions/restore-an-archived-question"}]},{"group":"Rubrics","pages":[{"title":"List rubrics","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/rubrics","href":"/reference/v5/rubrics/list-rubrics"},{"title":"Create a rubric","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/rubrics","href":"/reference/v5/rubrics/create-a-rubric"},{"title":"Get a rubric","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/rubrics/{rubric_id}","href":"/reference/v5/rubrics/get-a-rubric"},{"title":"Archive a rubric","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/rubrics/{rubric_id}","href":"/reference/v5/rubrics/archive-a-rubric"},{"title":"Update or restore a rubric","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/rubrics/{rubric_id}","href":"/reference/v5/rubrics/update-or-restore-a-rubric"},{"title":"Add a criterion to a rubric","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/rubrics/{rubric_id}/criteria","href":"/reference/v5/rubrics/add-a-criterion-to-a-rubric"},{"title":"Update a criterion","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/rubrics/{rubric_id}/criteria/{rubric_criteria_id}","href":"/reference/v5/rubrics/update-a-criterion"},{"title":"List criterion versions","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/rubrics/{rubric_id}/criteria/{rubric_criteria_id}/versions","href":"/reference/v5/rubrics/list-criterion-versions"}]},{"group":"Vector Stores","pages":[{"title":"List Vector Stores","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/vector-stores","href":"/reference/v5/vector-stores/list-vector-stores"},{"title":"Create Vector Store","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/create","href":"/reference/v5/vector-stores/create-vector-store"},{"title":"Get Vector Store","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/vector-stores/{vector_store_name}","href":"/reference/v5/vector-stores/get-vector-store"},{"title":"Configure Vector Store","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/{vector_store_name}/configure","href":"/reference/v5/vector-stores/configure-vector-store"},{"title":"Drop Vector Store","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/{vector_store_name}/drop","href":"/reference/v5/vector-stores/drop-vector-store"},{"title":"Upsert Vectors","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/{vector_store_name}/upsert","href":"/reference/v5/vector-stores/upsert-vectors"},{"title":"Delete Vectors","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/{vector_store_name}/delete","href":"/reference/v5/vector-stores/delete-vectors"},{"title":"List Vectors","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/vector-stores/{vector_store_name}/vectors","href":"/reference/v5/vector-stores/list-vectors"},{"title":"Get Vector","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/vector-stores/{vector_store_name}/vectors/{vector_id}","href":"/reference/v5/vector-stores/get-vector"},{"title":"Count Vectors","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/{vector_store_name}/count","href":"/reference/v5/vector-stores/count-vectors"},{"title":"Query Vectors","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/vector-stores/{vector_store_name}/query","href":"/reference/v5/vector-stores/query-vectors"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/files","href":"/reference/v5/files/list-files"},{"title":"Upload file bytes directly","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/files","href":"/reference/v5/files/upload-file-bytes-directly"},{"title":"Import files from cloud storage","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/files/cloud_imports","href":"/reference/v5/files/import-files-from-cloud-storage"},{"title":"Get file metadata","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/files/{file_id}","href":"/reference/v5/files/get-file-metadata"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/files/{file_id}","href":"/reference/v5/files/delete-a-file"},{"title":"Update a file","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/files/{file_id}","href":"/reference/v5/files/update-a-file"},{"title":"Download file content","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/files/{file_id}/content","href":"/reference/v5/files/download-file-content"}]},{"group":"Models","pages":[{"title":"List custom models","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/models","href":"/reference/v5/models/list-custom-models"},{"title":"Create a custom model","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/models","href":"/reference/v5/models/create-a-custom-model"},{"title":"Get a custom model","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/models/{model_id}","href":"/reference/v5/models/get-a-custom-model"},{"title":"Delete a custom model","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/models/{model_id}","href":"/reference/v5/models/delete-a-custom-model"},{"title":"Update a custom model","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/models/{model_id}","href":"/reference/v5/models/update-a-custom-model"}]},{"group":"Agent Configs","pages":[{"title":"List Agent Configs","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/agent_configs","href":"/reference/v5/agent-configs/list-agent-configs"},{"title":"Create Agent Config","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/agent_configs","href":"/reference/v5/agent-configs/create-agent-config"},{"title":"List MCP Tool Names","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/agent_configs/mcp_tools","href":"/reference/v5/agent-configs/list-mcp-tool-names"},{"title":"Get Agent Config","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/agent_configs/{agent_config_id}","href":"/reference/v5/agent-configs/get-agent-config"},{"title":"Delete Agent Config (hard delete)","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/agent_configs/{agent_config_id}","href":"/reference/v5/agent-configs/delete-agent-config-hard-delete"},{"title":"Update Agent Config","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/agent_configs/{agent_config_id}","href":"/reference/v5/agent-configs/update-agent-config"}]},{"group":"Datasets","pages":[{"title":"List datasets","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/datasets","href":"/reference/v5/datasets/list-datasets"},{"title":"Create a dataset","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/datasets","href":"/reference/v5/datasets/create-a-dataset"},{"title":"Get a dataset","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/datasets/{dataset_id}","href":"/reference/v5/datasets/get-a-dataset"},{"title":"Archive a dataset","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/datasets/{dataset_id}","href":"/reference/v5/datasets/archive-a-dataset"},{"title":"Update or restore a dataset","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/datasets/{dataset_id}","href":"/reference/v5/datasets/update-or-restore-a-dataset"}]},{"group":"Dataset Items","pages":[{"title":"Add items to an existing dataset","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/dataset-items/batch","href":"/reference/v5/dataset-items/add-items-to-an-existing-dataset"},{"title":"Get a dataset item","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/dataset-items/{dataset_item_id}","href":"/reference/v5/dataset-items/get-a-dataset-item"},{"title":"Delete a dataset item","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/dataset-items/{dataset_item_id}","href":"/reference/v5/dataset-items/delete-a-dataset-item"},{"title":"Update a dataset item","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/dataset-items/{dataset_item_id}","href":"/reference/v5/dataset-items/update-a-dataset-item"},{"title":"List dataset items","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/dataset-items","href":"/reference/v5/dataset-items/list-dataset-items"}]},{"group":"Evaluations","pages":[{"title":"List Evaluations","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluations","href":"/reference/v5/evaluations/list-evaluations"},{"title":"Create Evaluation","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluations","href":"/reference/v5/evaluations/create-evaluation"},{"title":"Get Evaluation","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluations/{evaluation_id}","href":"/reference/v5/evaluations/get-evaluation"},{"title":"Archive Evaluation","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/evaluations/{evaluation_id}","href":"/reference/v5/evaluations/archive-evaluation"},{"title":"Update or Restore Evaluation","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/evaluations/{evaluation_id}","href":"/reference/v5/evaluations/update-or-restore-evaluation"},{"title":"Add Test Criteria to Evaluation","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluations/{evaluation_id}/tasks","href":"/reference/v5/evaluations/add-test-criteria-to-evaluation"},{"title":"Update Test Criteria Configuration","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/evaluations/{evaluation_id}/tasks/{alias}","href":"/reference/v5/evaluations/update-test-criteria-configuration"},{"title":"Get Available Metadata Keys","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluations/metadata-keys","href":"/reference/v5/evaluations/get-available-metadata-keys"},{"title":"Get Available Evaluation Statuses","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluations/statuses","href":"/reference/v5/evaluations/get-available-evaluation-statuses"},{"title":"Get Evaluation Data Schema","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluations/{evaluation_id}/schema","href":"/reference/v5/evaluations/get-evaluation-data-schema"},{"title":"Get Evaluation Taxonomy","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluations/{evaluation_id}/taxonomy","href":"/reference/v5/evaluations/get-evaluation-taxonomy"},{"title":"Filter Evaluations","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluations/filter","href":"/reference/v5/evaluations/filter-evaluations"},{"title":"Dry-run a custom-function evaluation task","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluations/tasks/dry-run","href":"/reference/v5/evaluations/dry-run-a-custom-function-evaluation-task"}]},{"group":"Evaluation Groups","pages":[{"title":"List Evaluation Groups","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-groups","href":"/reference/v5/evaluation-groups/list-evaluation-groups"},{"title":"Create Evaluation Group","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluation-groups","href":"/reference/v5/evaluation-groups/create-evaluation-group"},{"title":"Get Evaluation Group","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-groups/{group_id}","href":"/reference/v5/evaluation-groups/get-evaluation-group"},{"title":"Update Evaluation Group","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml put /v5/evaluation-groups/{group_id}","href":"/reference/v5/evaluation-groups/update-evaluation-group"},{"title":"Archive Evaluation Group","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/evaluation-groups/{group_id}","href":"/reference/v5/evaluation-groups/archive-evaluation-group"},{"title":"Patch Evaluation Group","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/evaluation-groups/{group_id}","href":"/reference/v5/evaluation-groups/patch-evaluation-group"},{"title":"Get Evaluation Group Schema","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-groups/{group_id}/schema","href":"/reference/v5/evaluation-groups/get-evaluation-group-schema"}]},{"group":"Evaluation Charts","pages":[{"title":"List Evaluation Charts","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-charts","href":"/reference/v5/evaluation-charts/list-evaluation-charts"},{"title":"Create Evaluation Chart","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluation-charts","href":"/reference/v5/evaluation-charts/create-evaluation-chart"},{"title":"Get Evaluation Chart","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-charts/{chart_id}","href":"/reference/v5/evaluation-charts/get-evaluation-chart"},{"title":"Replace Evaluation Chart","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml put /v5/evaluation-charts/{chart_id}","href":"/reference/v5/evaluation-charts/replace-evaluation-chart"},{"title":"Delete Evaluation Chart","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml delete /v5/evaluation-charts/{chart_id}","href":"/reference/v5/evaluation-charts/delete-evaluation-chart"},{"title":"Patch Evaluation Chart","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml patch /v5/evaluation-charts/{chart_id}","href":"/reference/v5/evaluation-charts/patch-evaluation-chart"}]},{"group":"Evaluation Dashboards","pages":[{"title":"List Evaluation Dashboards","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-dashboards","href":"/reference/v5/evaluation-dashboards/list-evaluation-dashboards"},{"title":"Create Evaluation Dashboard","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluation-dashboards","href":"/reference/v5/evaluation-dashboards/create-evaluation-dashboard"},{"title":"Get Evaluation Dashboard","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-dashboards/{dashboard_id}","href":"/reference/v5/evaluation-dashboards/get-evaluation-dashboard"},{"title":"Delete Evaluation Dashboard","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/evaluation-dashboards/{dashboard_id}","href":"/reference/v5/evaluation-dashboards/delete-evaluation-dashboard"},{"title":"Patch Evaluation Dashboard","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/evaluation-dashboards/{dashboard_id}","href":"/reference/v5/evaluation-dashboards/patch-evaluation-dashboard"},{"title":"Add Widget to Dashboard","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluation-dashboards/{dashboard_id}/widgets","href":"/reference/v5/evaluation-dashboards/add-widget-to-dashboard"},{"title":"Remove Widget from Dashboard","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/evaluation-dashboards/{dashboard_id}/widgets/{widget_id}","href":"/reference/v5/evaluation-dashboards/remove-widget-from-dashboard"},{"title":"Update Dashboard Widget","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/evaluation-dashboards/{dashboard_id}/widgets/{widget_id}","href":"/reference/v5/evaluation-dashboards/update-dashboard-widget"}]},{"group":"Evaluation Items","pages":[{"title":"Get a single evaluation item","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-items/{evaluation_item_id}","href":"/reference/v5/evaluation-items/get-a-single-evaluation-item"},{"title":"List and filter evaluation items","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/evaluation-items","href":"/reference/v5/evaluation-items/list-and-filter-evaluation-items"},{"title":"Export evaluation items to a file","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/evaluation-items/export","href":"/reference/v5/evaluation-items/export-evaluation-items-to-a-file"}]},{"group":"Spans","pages":[{"title":"Create a span","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans","href":"/reference/v5/spans/create-a-span"},{"title":"Upsert spans in a batch","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml put /v5/spans/batch","href":"/reference/v5/spans/upsert-spans-in-a-batch"},{"title":"Create spans in a batch","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans/batch","href":"/reference/v5/spans/create-spans-in-a-batch"},{"title":"List trace deletion requests","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/spans/deletions","href":"/reference/v5/spans/list-trace-deletion-requests"},{"title":"Create trace deletion request","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans/deletions","href":"/reference/v5/spans/create-trace-deletion-request"},{"title":"Get trace deletion request status","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/spans/deletions/{deletion_request_id}","href":"/reference/v5/spans/get-trace-deletion-request-status"},{"title":"Get a span","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml get /v5/spans/{span_id}","href":"/reference/v5/spans/get-a-span"},{"title":"Update a span","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/spans/{span_id}","href":"/reference/v5/spans/update-a-span"},{"title":"Get a span within a trace","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/traces/{trace_id}/spans/{span_id}","href":"/reference/v5/spans/get-a-span-within-a-trace"},{"title":"List span summaries for a trace","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/traces/{trace_id}/spans","href":"/reference/v5/spans/list-span-summaries-for-a-trace"},{"title":"Search spans","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans/search","href":"/reference/v5/spans/search-spans"},{"title":"Export spans","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans/export","href":"/reference/v5/spans/export-spans"},{"title":"Get span export status","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/spans/export/{export_id}","href":"/reference/v5/spans/get-span-export-status"},{"title":"Get time-bucketed span metrics","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans/metrics","href":"/reference/v5/spans/get-time-bucketed-span-metrics"},{"title":"Get span metrics grouped by name","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/spans/metrics/by-span","href":"/reference/v5/spans/get-span-metrics-grouped-by-name"}]},{"group":"Span Assessment","pages":[{"title":"List span or trace assessments","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/span-assessments","href":"/reference/v5/span-assessment/list-span-or-trace-assessments"},{"title":"Create span assessment","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/span-assessments","href":"/reference/v5/span-assessment/create-span-assessment"},{"title":"Get span assessment by ID","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/span-assessments/{span_assessment_id}","href":"/reference/v5/span-assessment/get-span-assessment-by-id"},{"title":"Permanently delete span assessment","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/span-assessments/{span_assessment_id}","href":"/reference/v5/span-assessment/permanently-delete-span-assessment"},{"title":"Update span assessment","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/span-assessments/{span_assessment_id}","href":"/reference/v5/span-assessment/update-span-assessment"}]},{"group":"Annotation Tasks","pages":[{"title":"Update or assign annotation tasks in bulk","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/annotation-tasks/batch","href":"/reference/v5/annotation-tasks/update-or-assign-annotation-tasks-in-bulk"}]},{"group":"Credentials","pages":[{"title":"List Credentials","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/credentials","href":"/reference/v5/credentials/list-credentials"},{"title":"Create Credential","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/credentials","href":"/reference/v5/credentials/create-credential"},{"title":"Get Credential by Name","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/credentials/name/{credential_name}","href":"/reference/v5/credentials/get-credential-by-name"},{"title":"Get Credential by ID","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/credentials/{credential_id}","href":"/reference/v5/credentials/get-credential-by-id"},{"title":"Delete Credential","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/credentials/{credential_id}","href":"/reference/v5/credentials/delete-credential"},{"title":"Update Credential","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml patch /v5/credentials/{credential_id}","href":"/reference/v5/credentials/update-credential"},{"title":"Get Credential Secret by ID","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/credentials/{credential_id}/secret","href":"/reference/v5/credentials/get-credential-secret-by-id"},{"title":"Get Credential Secret by Name","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/credentials/name/{credential_name}/secret","href":"/reference/v5/credentials/get-credential-secret-by-name"}]},{"group":"Agentex Cloud Build","pages":[{"title":"List container image builds","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/builds","href":"/reference/v5/agentex-cloud-build/list-container-image-builds"},{"title":"Submit container image build","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/builds","href":"/reference/v5/agentex-cloud-build/submit-container-image-build"},{"title":"List agents built but not deployed","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/builds/undeployed","href":"/reference/v5/agentex-cloud-build/list-agents-built-but-not-deployed"},{"title":"Get a build","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/builds/{build_id}","href":"/reference/v5/agentex-cloud-build/get-a-build"},{"title":"Stream build logs","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/builds/{build_id}/logs","href":"/reference/v5/agentex-cloud-build/stream-build-logs"},{"title":"Cancel a build","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/builds/{build_id}/cancel","href":"/reference/v5/agentex-cloud-build/cancel-a-build"}]},{"group":"Agentex Cloud Deploy","pages":[{"title":"List agent deployments","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/agentex/deployments","href":"/reference/v5/agentex-cloud-deploy/list-agent-deployments"},{"title":"Deploy a built agent image","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml post /v5/agentex/deployments","href":"/reference/v5/agentex-cloud-deploy/deploy-a-built-agent-image"},{"title":"Get an agent deployment","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/agentex/deployments/{deployment_id}","href":"/reference/v5/agentex-cloud-deploy/get-an-agent-deployment"},{"title":"Delete and tear down a deployment","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/agentex/deployments/{deployment_id}","href":"/reference/v5/agentex-cloud-deploy/delete-and-tear-down-a-deployment"},{"title":"Get agent deployment logs","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml get /v5/agentex/deployments/{deployment_id}/logs","href":"/reference/v5/agentex-cloud-deploy/get-agent-deployment-logs"}]},{"group":"Agentex Agent","pages":[{"title":"Delete Agent","deprecated":null,"version":null,"openapi":"/openapi/v5.yaml delete /v5/agentex/agents/{agent_id}","href":"/reference/v5/agentex-agent/delete-agent"}]},{"group":"SGP Cloud Secrets","pages":[{"title":"List Secrets","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml get /v5/sgp/secrets","href":"/reference/v5/sgp-cloud-secrets/list-secrets"},{"title":"Create Secret","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml post /v5/sgp/secrets","href":"/reference/v5/sgp-cloud-secrets/create-secret"},{"title":"Get Secret","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml get /v5/sgp/secrets/{secret_id}","href":"/reference/v5/sgp-cloud-secrets/get-secret"},{"title":"Delete Secret","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml delete /v5/sgp/secrets/{secret_id}","href":"/reference/v5/sgp-cloud-secrets/delete-secret"},{"title":"Update Secret","deprecated":true,"version":null,"openapi":"/openapi/v5.yaml patch /v5/sgp/secrets/{secret_id}","href":"/reference/v5/sgp-cloud-secrets/update-secret"}]}]},{"tab":"AgentOps SDK","href":"https://scaleapi.github.io/sgp-sdk-docs/api/python/"},{"tab":"Agentex API","pages":[{"title":"Agentex API","href":"/reference/agentex/agents/get-agent-by-id"}]},{"tab":"Agentex SDK","href":"https://scaleapi.github.io/agentex-sdk-docs/api/python/"},{"tab":"Capabilities","pages":[{"title":"Capabilities","href":"/docs/capabilities/overview"}]},{"tab":"Dex API","pages":[{"title":"Dex API","href":"/reference/dex/projects/list-projects"}]}]},{"version":"V4 (legacy)","pages":[{"title":"V4 (legacy)","href":"/reference/v4/questions/list-questions"}]}]},"basePath":"","title":"Create a question - Scale AI","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}