Showtime - Current Show

Set the current show through the API

Endpoint

/api/v1/<your-handle>/shows/current

GET

Read the current show.

POST

Set the current show.

DELETE

Clear the current show.

Set the current show

Name the show outright when you know its ID:

curl -X POST "https://confirmed.show/api/v1/<your-handle>/shows/current?show_id=ab12" \
     -H "X-API-Token: your-key"

Leave show_id off and the API will work out which show is currently active

curl -X POST "https://confirmed.show/api/v1/<your-handle>/shows/current" \
     -H "X-API-Token: your-key"

The call picks the show that is running right now. A show stays live until 30 minutes past its scheduled finish, or until five minutes before the next one starts, whichever comes first, and then the next show takes over. With nothing running, the next show on the schedule becomes the current show.

Narrow the search when your production runs several shows at once:

Query parameters

Parameter	Description
`show_id`	The show to mark current. Skips the search below.
`venue_id`	Only consider shows at this venue.
`room_id`	Only consider shows in this room. Pair it with `venue_id`.
`show_type`	Only consider shows of this type.

The response tells you which show we settled on:

{"status": "ok", "show_id": "ab12"}

Read the current show

curl "https://confirmed.show/api/v1/<your-handle>/shows/current" \
     -H "X-API-Token: your-key"

{"show_id": "ab12"}

You get {"show_id": null} when no show is marked current.

Clear the current show

curl -X DELETE "https://confirmed.show/api/v1/<your-handle>/shows/current" \
     -H "X-API-Token: your-key"

{"status": "ok", "show_id": null}

Clearing the flag hands Confirmed back to its own judgement: it falls back to whichever show the schedule says is running. Worth doing at the end of a run so last week's show stops greeting your team.

Was this helpful?