On this page
trainingQuestions
query · in the family Training question
What it does
Your organization group’s question bank, newest first, across every course.
The caller's org-group family's ACTIVE LISTING of TrainingQuestions — doomed records DROP from listings. PAGINATED: limit clamps to [1, 200], default 100; nextToken = the prior page's cursor, verbatim — opaque + tenant-bound (a malformed or foreign token → VALIDATION/INVALID). Walk until nextToken is null (a page may hold fewer than limit — doomed drop per page).
What happens
Read-only.
Who may call it
Capability area: Training — Courses, tests, certificates and the training rules of your team.
- Owner
- System Administrator
- Manager
- An API key whose scope allows
api:trainingQuestions
Arguments
| Name | Type | Required | Notes |
|---|---|---|---|
limit | Int | no | How many records to answer at most; a page may hold fewer. |
nextToken | String | no | The cursor from the previous page, passed back exactly as received. |
Returns
TrainingQuestionPage TrainingQuestionPage! — One page of the trainingQuestions listing — the records + the opaque resume cursor.
This is a page: items holds the records and nextToken the cursor for the next page — pass it back verbatim until it is null. See paging.
Example request
query ExampleTrainingQuestions($limit: Int) {
trainingQuestions(limit: $limit) {
items {
id
sysId
type
caption
status
parentId
rootId
createdAt
updatedAt
revisionNum
revision
courseKey
stepN
prompt
options
correctIndex
explanation
source
}
nextToken
}
}
Variables:
{
"limit": 1
}
Example response
{
"data": {
"trainingQuestions": {
"items": [
{
"id": "01900000-0000-7000-8000-37386ae00000",
"sysId": "TQ-EXMP-0000-000F",
"type": "TrainingQuestion",
"caption": "Blue jeans",
"status": "active",
"parentId": "01900000-0000-7000-8000-065235280000",
"rootId": "01900000-0000-7000-8000-a093dd800000",
"createdAt": "2027-01-31T00:00:00.000Z",
"updatedAt": "2027-01-31T00:00:00.000Z",
"revisionNum": 1,
"revision": "01900000-0000-7000-8000-b7960e180000",
"courseKey": "<course key>",
"stepN": 1,
"prompt": "<prompt>",
"options": [
"<options>"
],
"correctIndex": 1,
"explanation": "<explanation>",
"source": "<source>"
}
],
"nextToken": "<the cursor from the previous page>"
}
},
"extensions": {
"at": {
"callId": "01EXAMPLE-CALL-ID",
"version": {
"requested": null,
"serviced": {
"name": "genesis",
"number": 0
}
}
}
}
}
Errors this call can answer
VALIDATION/INVALID— Something in the request is not valid. (VALIDATION)AUTHN/REQUIRED— Sign in to do this. (AUTHN)AUTHZ/FORBIDDEN— Your role does not allow this action. (AUTHZ)RATE_LIMIT/THROTTLED— Too many requests in a short time. (RATE_LIMIT)