Title83/100
Get a 12 Axes quiz
Shorten the title to an action and subject; move usage details into the description.
Description85/100
Start the 36-, 60-, or 240-question political test, or resume with a saved resume_token. Ask one statement at a time. Record chosen answers with axes_record_answers and keep its latest token. quiz_id and next_offset still support stateless pagination.
The description explains the capability, when to use it, and what to expect.
Inputs54/100
4 of 6 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
language
Question language, default en. The quiz_id selects the language for later pages.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
variant
short has 36 questions, extended has 60, extreme has 240. The default is short.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
quiz_id
The quiz_id returned by axes_get_questions.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
resume_token
Latest resume_token. It contains the recorded choices: keep it in the client, not in public links.
Clear enough to supply this argument.
offset
Not provided
Missing description. Explain what this value means and how to supply it.
limit
Not provided
Missing description. Explain what this value means and how to supply it.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}Output schema76/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quiz_id",
"language",
"variant",
"total_questions",
"next_offset",
"resume_token",
"answered",
"complete",
"progress_percent",
"next_question",
"answer_options",
"questions",
"source_url"
],
"properties": {
"quiz_id": {
"type": "string",
"pattern": "^(?:q2\\.([0-9a-f]{16})\\.([0-9a-f]{16})|([0-9a-f]{16}))\\.([a-z-]+)\\.(short|extended|extreme)\\.([0-9a-f]{8}|[0-9a-f]{32})$",
"maxLength": 96,
"description": "The quiz_id returned by axes_get_questions."
},
"variant": {
"enum": [
"short",
"extended",
"extreme"
],
"type": "string"
},
"answered": {
"type": "number"
},
"complete": {
"type": "boolean"
},
"language": {
"enum": [
"en",
"pt",
"es",
"de",
"it",
"ru",
"zh",
"zh-hant",
"ko",
"ja",
"fr",
"hi"
],
"type": "string"
},
"questions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
}
},
"additionalProperties": false
}
},
"attempt_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "Forward the random attempt_id from this quiz to connect operational events. Never use a score or category as this ID."
},
"source_url": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"resume_token": {
"type": "string",
"maxLength": 704,
"minLength": 1,
"description": "Latest resume_token. It contains the recorded choices: keep it in the client, not in public links."
},
"next_question": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"text",
"number"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"number": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"answer_options": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"enum": [
"STRONGLY_AGREE",
"AGREE",
"NEUTRAL",
"DISAGREE",
"STRONGLY_DISAGREE"
],
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total_questions": {
"type": "number"
},
"progress_percent": {
"type": "number"
}
},
"additionalProperties": false
}