Set Lists

List set lists

GET/v1/teams/{teamId}/days/{dayId}/events/{eventId}/set-lists

Lists set list records for an event.

Required scopes: set_list:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

Response 200

`data`	`object[]`
`data[].dayId`	`string:uuid` Day identifier that owns the event for this set list.
`data[].eventId`	`string:uuid` Event identifier that owns this set list.
`data[].title`	`string` Set list title.
`data[].visibility`	`object` Optional visibility rules for the set list.
`data[].visibility.groupIds`	`string:uuid[]`
`data[].visibility.userIds`	`string:uuid[]`
`data[].items`	`libraryItem \| break[]` Ordered set list entries. Each entry uses type "libraryItem" or type "break" to determine its shape.
`data[].items[].id`	`string:uuid` Set list entry identifier.
`data[].items[].type`	`"libraryItem" \| "break"` libraryItem: Use "libraryItem" for an entry backed by a reusable set list item. break: Use "break" for an intermission, pause, or other timed break in the set list.
`data[].items[].setListItemId`	`string:uuid` Reusable set list item identifier. Required when type is "libraryItem".
`data[].items[].title`	`string` libraryItem: Optional per-set override title. When omitted, RoadOps uses the library item title. break: Break label shown in the set list. Required when type is "break".
`data[].items[].durationSeconds`	`integer` libraryItem: Optional per-set duration override in seconds. When omitted, RoadOps uses the library item duration. break: Break duration in seconds. Required when type is "break".
`data[].items[].printTitle`	`string` Optional per-set print title override.
`data[].items[].notes`	`string` Optional notes for this set list entry.
`data[].id`	`string:uuid` Set list identifier.
`data[].orgId`	`string:uuid` Team identifier that owns this set list.
`data[].isDeleted`	`boolean` Whether the set list has been deleted.
`data[].version`	`integer` Current set list aggregate version.
`data[].createdAt`	`string:date-time` ISO 8601 timestamp when the set list was created.
`data[].createdBy`	`string` User identifier that created this set list.
`data[].updatedAt`	`string:date-time` ISO 8601 timestamp when the set list was last updated.
`data[].updatedBy`	`string` User identifier that last updated this set list.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this set list record.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.
`meta`	`object`
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

Response: List set lists

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000901",
      "title": "Main set",
      "visibility": {
        "userIds": [
          "00000000-0000-4000-8000-000000000101"
        ]
      },
      "items": [
        {
          "id": "00000000-0000-4000-8000-000000000902",
          "type": "libraryItem",
          "setListItemId": "00000000-0000-4000-8000-000000000911",
          "title": "Opening Song",
          "durationSeconds": 240,
          "printTitle": "Opening Song",
          "notes": "Start with click track."
        },
        {
          "id": "00000000-0000-4000-8000-000000000903",
          "type": "break",
          "title": "Intermission",
          "durationSeconds": 900
        }
      ],
      "dayId": "00000000-0000-4000-8000-000000000201",
      "eventId": "00000000-0000-4000-8000-000000000601",
      "orgId": "00000000-0000-4000-8000-000000000100",
      "isDeleted": false,
      "createdBy": "00000000-0000-4000-8000-000000000101",
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedBy": "00000000-0000-4000-8000-000000000101",
      "updatedAt": "2026-09-01T12:00:00.000Z",
      "version": 1,
      "cursor": 87234
    }
  ],
  "page": {
    "limit": 50,
    "nextCursor": null
  },
  "meta": {
    "cursor": 87234
  }
}

Create a set list

POST/v1/teams/{teamId}/days/{dayId}/events/{eventId}/set-lists

Accepts a command to create a set list for an event.

Required scopes: set_list:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`title`required	`string` Set list title.
`visibility`	`object` Optional visibility rules for this set list.
`visibility.groupIds`	`string:uuid[]`
`visibility.userIds`	`string:uuid[]`
`items`required	`libraryItem \| break[]` Ordered set list entries. Each entry uses type "libraryItem" or type "break" to determine its shape.
`items[].id`required	`string:uuid` Set list entry identifier.
`items[].type`required	`"libraryItem" \| "break"` libraryItem: Use "libraryItem" for an entry backed by a reusable set list item. break: Use "break" for an intermission, pause, or other timed break in the set list.
`items[].setListItemId`	`string:uuid` Reusable set list item identifier. Required when type is "libraryItem".
`items[].title`	`string` libraryItem: Optional per-set override title. When omitted, RoadOps uses the library item title. break: Break label shown in the set list. Required when type is "break".
`items[].durationSeconds`	`integer` libraryItem: Optional per-set duration override in seconds. When omitted, RoadOps uses the library item duration. break: Break duration in seconds. Required when type is "break".
`items[].printTitle`	`string` Optional per-set print title override.
`items[].notes`	`string` Optional notes for this set list entry.
`id`	`string:uuid` Optional caller-supplied set list ID. RoadOps generates one when omitted.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Create set list

{
  "id": "00000000-0000-4000-8000-000000000901",
  "title": "Main set",
  "visibility": {
    "userIds": [
      "00000000-0000-4000-8000-000000000101"
    ]
  },
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000902",
      "type": "libraryItem",
      "setListItemId": "00000000-0000-4000-8000-000000000911",
      "title": "Opening Song",
      "durationSeconds": 240,
      "printTitle": "Opening Song",
      "notes": "Start with click track."
    },
    {
      "id": "00000000-0000-4000-8000-000000000903",
      "type": "break",
      "title": "Intermission",
      "durationSeconds": 900
    }
  ]
}

Response: Create set list

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000901",
  "resourceType": "set_list",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/events/00000000-0000-4000-8000-000000000601/set-lists/00000000-0000-4000-8000-000000000901"
  }
}

Retrieve a set list

GET/v1/teams/{teamId}/days/{dayId}/events/{eventId}/set-lists/{setListId}

Returns one set list record by ID.

Required scopes: set_list:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`path.setListId`required	`string:uuid` Set list identifier.

Response 200

`data`	`object`
`data.dayId`	`string:uuid` Day identifier that owns the event for this set list.
`data.eventId`	`string:uuid` Event identifier that owns this set list.
`data.title`	`string` Set list title.
`data.visibility`	`object` Optional visibility rules for the set list.
`data.visibility.groupIds`	`string:uuid[]`
`data.visibility.userIds`	`string:uuid[]`
`data.items`	`libraryItem \| break[]` Ordered set list entries. Each entry uses type "libraryItem" or type "break" to determine its shape.
`data.items[].id`	`string:uuid` Set list entry identifier.
`data.items[].type`	`"libraryItem" \| "break"` libraryItem: Use "libraryItem" for an entry backed by a reusable set list item. break: Use "break" for an intermission, pause, or other timed break in the set list.
`data.items[].setListItemId`	`string:uuid` Reusable set list item identifier. Required when type is "libraryItem".
`data.items[].title`	`string` libraryItem: Optional per-set override title. When omitted, RoadOps uses the library item title. break: Break label shown in the set list. Required when type is "break".
`data.items[].durationSeconds`	`integer` libraryItem: Optional per-set duration override in seconds. When omitted, RoadOps uses the library item duration. break: Break duration in seconds. Required when type is "break".
`data.items[].printTitle`	`string` Optional per-set print title override.
`data.items[].notes`	`string` Optional notes for this set list entry.
`data.id`	`string:uuid` Set list identifier.
`data.orgId`	`string:uuid` Team identifier that owns this set list.
`data.isDeleted`	`boolean` Whether the set list has been deleted.
`data.version`	`integer` Current set list aggregate version.
`data.createdAt`	`string:date-time` ISO 8601 timestamp when the set list was created.
`data.createdBy`	`string` User identifier that created this set list.
`data.updatedAt`	`string:date-time` ISO 8601 timestamp when the set list was last updated.
`data.updatedBy`	`string` User identifier that last updated this set list.
`data.cursor`	`integer` Latest event-ledger cursor projected into this set list record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

Response: Retrieve set list

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000901",
    "title": "Main set",
    "visibility": {
      "userIds": [
        "00000000-0000-4000-8000-000000000101"
      ]
    },
    "items": [
      {
        "id": "00000000-0000-4000-8000-000000000902",
        "type": "libraryItem",
        "setListItemId": "00000000-0000-4000-8000-000000000911",
        "title": "Opening Song",
        "durationSeconds": 240,
        "printTitle": "Opening Song",
        "notes": "Start with click track."
      },
      {
        "id": "00000000-0000-4000-8000-000000000903",
        "type": "break",
        "title": "Intermission",
        "durationSeconds": 900
      }
    ],
    "dayId": "00000000-0000-4000-8000-000000000201",
    "eventId": "00000000-0000-4000-8000-000000000601",
    "orgId": "00000000-0000-4000-8000-000000000100",
    "isDeleted": false,
    "createdBy": "00000000-0000-4000-8000-000000000101",
    "createdAt": "2026-09-01T12:00:00.000Z",
    "updatedBy": "00000000-0000-4000-8000-000000000101",
    "updatedAt": "2026-09-01T12:00:00.000Z",
    "version": 1,
    "cursor": 87234
  },
  "meta": {
    "cursor": 87234
  }
}

Update a set list

PATCH/v1/teams/{teamId}/days/{dayId}/events/{eventId}/set-lists/{setListId}

Accepts a command to update set list fields.

Required scopes: set_list:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`path.setListId`required	`string:uuid` Set list identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`updates`required	`object` Set list fields to update.
`updates.title`	`string` Set list title.
`updates.items`	`libraryItem \| break[]` Ordered set list entries. Each entry uses type "libraryItem" or type "break" to determine its shape.
`updates.items[].id`required	`string:uuid` Set list entry identifier.
`updates.items[].type`required	`"libraryItem" \| "break"` libraryItem: Use "libraryItem" for an entry backed by a reusable set list item. break: Use "break" for an intermission, pause, or other timed break in the set list.
`updates.items[].setListItemId`	`string:uuid` Reusable set list item identifier. Required when type is "libraryItem".
`updates.items[].title`	`string` libraryItem: Optional per-set override title. When omitted, RoadOps uses the library item title. break: Break label shown in the set list. Required when type is "break".
`updates.items[].durationSeconds`	`integer` libraryItem: Optional per-set duration override in seconds. When omitted, RoadOps uses the library item duration. break: Break duration in seconds. Required when type is "break".
`updates.items[].printTitle`	`string` Optional per-set print title override.
`updates.items[].notes`	`string` Optional notes for this set list entry.
`updates.visibility`	`object \| null` Updated visibility rules, or null to clear them.
`updates.visibility.groupIds`	`string:uuid[]`
`updates.visibility.userIds`	`string:uuid[]`

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Update set list

{
  "updates": {
    "title": "Encore set",
    "visibility": null,
    "items": [
      {
        "id": "00000000-0000-4000-8000-000000000904",
        "type": "libraryItem",
        "setListItemId": "00000000-0000-4000-8000-000000000911",
        "title": "Encore Opener"
      },
      {
        "id": "00000000-0000-4000-8000-000000000905",
        "type": "break",
        "title": "Band changeover",
        "durationSeconds": 300
      }
    ]
  }
}

Response: Update set list

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000901",
  "resourceType": "set_list",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/events/00000000-0000-4000-8000-000000000601/set-lists/00000000-0000-4000-8000-000000000901"
  }
}

Delete a set list

DELETE/v1/teams/{teamId}/days/{dayId}/events/{eventId}/set-lists/{setListId}

Accepts a command to delete a set list.

Required scopes: set_list:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`path.setListId`required	`string:uuid` Set list identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.