View all methods

snapshots.settings.driverSelection.set

Set the complete driver selection. Omitted IDs are deselected; the selection must satisfy the library’s minimum and maximum counts.

Facts


Method	`POST https://api.getdx.com/snapshots.settings.driverSelection.set`
Required scope	`snapshots:admin`

Arguments

Name	Type	Description
`token`	`Token`	Auth token passed as an HTTP header.
`branch_id`	`Text`	Required when branching is enabled; omit when disabled. Get IDs from `snapshots.settings.branches`.
`driver_ids`	`Array<Text>`	Required. Complete set of selected IDs from `library`, without duplicates.

Example request

curl -X POST https://api.getdx.com/snapshots.settings.driverSelection.set \
  -H 'Authorization: Bearer xxxx-xxxxxxxxx-xxxx' \
  -H 'Content-Type: application/json' \
  --data '{
  "branch_id": "NTIxMDA",
  "driver_ids": ["NTIxNDc"]
}'

Example response

{
  "ok": true,
  "selection": {
    "branch_id": "NTIxMDA",
    "drivers": [
      {
        "id": "NTIxNDc",
        "name": "Toolchain efficiency",
        "prompt": "My tools help me work efficiently."
      }
    ],
    "minimum_drivers": 1,
    "maximum_drivers": 20
  }
}

Errors

not_authed or not_authorized for missing authentication or access. 422 validation_error for invalid input (error_details explains why); 409 snapshot_live while a snapshot is live.