Show control

Send a remote control command to whichever show is currently live. You can target a show directly by ID, or let the endpoint resolve the active show for you based on venue, room, or show type.

Endpoint

POST /api/v1/shows/control (GET also accepted)

Query Parameters

Parameter	Required	Description
`action`	Yes	The command to send. One of `next`, `prev`, or `toggle-break`.
`show_id`	No	Target a specific show. If omitted, the endpoint resolves the current live show from the parameters below.
`venue_id`	No	Narrow the active-show lookup to a venue.
`room_id`	No	Narrow the lookup to a room. Only valid alongside `venue_id`.
`show_type`	No	Narrow the lookup to a show type.

Example Request

curl -X POST "https://confirmed.show/api/v1/YOUR_PRODUCTION/shows/control?action=next" \
  -H "Authorization: Bearer YOUR_CONTROL_TOKEN"

Success Response

200 OK

{
  "status": "ok",
  "command_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab"
}

The command_id is a unique identifier for the command, useful for tracking or correlating the action.

Error Responses

Status	Body	Cause
`404`	`{ "error": "No current show found" }`	No live show matched the lookup parameters.
`422`	`{ "error": "room_id can only be used together with venue_id" }`	`room_id` was passed without `venue_id`.
`422`	`{ "error": [ ... ] }`	The `action` value is missing or not one of the accepted values.

Was this helpful?