Skip to content

undoBulkOperation

POST
/api/v1/screens/bulk/operations/{id}/undo
curl --request POST \
--url https://example.com/api/v1/screens/bulk/operations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/undo

Reverse a reversible bulk operation inside its undo window. Requires an Owner or Administrator with the write scope. Cookie-authenticated unsafe requests require X-CSRF-Token.

id
required
string format: uuid
X-CSRF-Token
string

Cookie-backed browser requests only, and only on unsafe methods. Bearer grants never send it.

Bulk operation reversed

Media typeapplication/json
object
data
required
object
id
required
string format: uuid
action
required
string
Allowed values: assign_playlist assign_layout clear_assignment set_enabled send_command
screenCount
required
integer
appliedCount
required
integer
skippedCount
required
integer
failedCount
required
integer
results
required
Array<object>

One screen inside a bulk preview or result. Current and Next are written for a person to read, not parsed.

object
screenId
required
string format: uuid
name
required
string
location
string
current
required
string
next
required
string
changes
required
boolean
blocked
string
fromGroup
string
selected
required
boolean
applied
boolean
error
string
reversible
required
boolean
undoExpiresAt
string format: date-time
undoneAt
string format: date-time
createdAt
required
string format: date-time
Example
{
"data": {
"action": "assign_playlist"
}
}

Dashboard authentication required

Insufficient role or screen scope

Bulk operation not found

Operation not reversible or undo unavailable