View all methods
snapshots.settings.library
Get driver, workflow, and CSAT libraries with selections for each branch.
Facts
| Method | GET https://api.getdx.com/snapshots.settings.library |
| Required scope | snapshots:admin |
Arguments
| Name | Type | Description |
|---|---|---|
token |
Token |
Auth token passed as an HTTP header. |
Each section contains library definitions and selections with enabled IDs, names, and prompts. branch_id is null when branching is disabled; CSAT groups is null when grouping is disabled.
See workflow definitions and CSAT definitions for populated examples. Only custom drivers and workflows can be updated.
Example request
curl -X GET https://api.getdx.com/snapshots.settings.library \
-H 'Authorization: Bearer xxxx-xxxxxxxxx-xxxx'
Example response
{
"ok": true,
"drivers": {
"library": [
{
"id": "NTIxNDc",
"name": "Toolchain efficiency",
"prompt": "My tools help me work efficiently.",
"ranking_item": "Improve tools",
"target_role": "all",
"custom": true,
"scale_points": 5,
"translations": {}
}
],
"selections": [
{
"branch_id": "NTIxMDA",
"drivers": [
{
"id": "NTIxNDc",
"name": "Toolchain efficiency",
"prompt": "My tools help me work efficiently."
}
],
"minimum_drivers": 1,
"maximum_drivers": 20
}
]
},
"workflows": {
"library": [],
"selections": [
{
"branch_id": "NTIxMDA",
"workflows": []
}
]
},
"csat": {
"library": [],
"selections": [
{
"branch_id": "NTIxMDA",
"csat": []
}
],
"groups": null
}
}
Errors
not_authed or not_authorized for missing authentication or access. Unsupported arguments return 422 validation_error.