# Confirmed API

> Confirmed is a booking platform for comedy productions. Its API reads and writes a production's shows, acts, venues and ticket sales, reads its team, and drives live shows. Requests go to https://hammersmith.getinvolved.app/api/v1/<production>/<endpoint> with an API key from the production's Data & API page.

Agent skills for these docs: `npx skills add rgb-monster/confirmed-skills` (https://github.com/rgb-monster/confirmed-skills)

## Public API

- [Shows](https://hammersmith.getinvolved.app/api-docs/public-shows.md): Your public shows as JSON: dates, venues, promotion and confirmed lineups.
- [Show type metadata](https://hammersmith.getinvolved.app/api-docs/show-type-metadata.md): Publish your own fields against each show type, and read them back as a static JSON file.

## Private API

- [Authentication and API tokens](https://hammersmith.getinvolved.app/api-docs/authentication.md): Where to put your token, and how the server looks for it.
- [Generate and manage API keys](https://hammersmith.getinvolved.app/api-docs/api-keys.md): Create, copy and delete keys from the Data & API page.
- [Shows](https://hammersmith.getinvolved.app/api-docs/shows.md): Read, create and update shows, their spots and their promotion.
- [Meta fields](https://hammersmith.getinvolved.app/api-docs/meta-fields.md): The custom fields your production keeps on shows and show types, with their names and types.
- [Ticket sales](https://hammersmith.getinvolved.app/api-docs/tickets.md): Read how many tickets each show has sold, and send in sales from your own ticket seller.
- [Show types](https://hammersmith.getinvolved.app/api-docs/show-types.md): Your show types, with the metadata you fill in for each.
- [Venues](https://hammersmith.getinvolved.app/api-docs/venues.md): Your venues and the rooms inside them: read them, add new ones and keep their details up to date.
- [Acts](https://hammersmith.getinvolved.app/api-docs/acts.md): The acts on your books: find them by name or tag, add new ones and keep their details up to date.
- [Team](https://hammersmith.getinvolved.app/api-docs/team.md): Who is on the production, and what they can do.
- [File upload](https://hammersmith.getinvolved.app/api-docs/file-upload.md): Get a signed URL, send your file, keep the link.

## Showtime

- [Show control](https://hammersmith.getinvolved.app/api-docs/show-control.md): Drive a live show from outside Confirmed: next, previous, break.
- [Current show](https://hammersmith.getinvolved.app/api-docs/current-show.md): Read, set and clear the show Confirmed treats as live.