# Changelog ## Versioning policy - **A breaking change means a new version**, `/v2`. `/v1` keeps running for 12 more months after `/v2` opens. - **Additions ship into `/v1` at any time** and are listed here: a new operation, a new field, a new optional parameter, or a new allowed value. Write your code to ignore what it doesn't know. A breaking change is one that can stop working code: removing or renaming an operation, a field, or a parameter, changing a field's type, or making an optional parameter required. ## November 16, 2026: version 1 The first release. - **Sign-in for AI agents.** An AI client connects by sending you to gumball.fm to approve it, as read-only or read and write, with no key to paste. A connection ends after 30 days, and **Connected Apps** on Account Settings lists and disconnects them. See [Authentication](https://gumball.fm/developers/authentication). - **API keys.** Create, view, and revoke keys on Account Settings, with read-only or read-and-write access and an expiry you choose. - **Account.** `whoami` returns the account a key acts as. - **Shows, for advertisers.** `search_shows`, `get_show`, and `list_show_slots` search shows and read their prices and open ad slots. - **My shows, for creators.** `list_my_shows` and `get_my_show` read the shows a creator is a member of, and `list_show_schedule` reads a show's schedule. - **Bookings.** `list_bookings` and `get_booking` read the bookings of a campaign, for an advertiser, or of a show, for a creator. - **Invoices and payouts.** `list_invoices` reads a campaign's invoices, for advertisers, and `list_payouts` reads a show's payouts, for creators. - **Campaigns and carts, for advertisers.** `list_campaigns`, `get_campaign`, and `create_campaign`; `start_campaign_build` and `get_campaign_build` pick shows for a budget; `add_cart_slots`, `remove_cart_slots`, `reserve_cart`, and `release_reserve` fill a cart and hold its slots. Nothing purchases. - **Schedule and bookings, for creators.** `add_episode`, `blackout_slots`, and `reopen_slots` manage a show's schedule; `submit_youtube_aircheck`, `set_social_post_link`, and `remove_social_post_link` deliver on a booking; `list_vetting_requests` and `answer_vetting_request` answer a brand's request. - **API Activity.** Every change made through the API is listed on its own page, linked from Account Settings. - **MCP server.** Every operation is also a tool for AI agents. - **Docs.** An interactive reference, guides, and plain-text copies for agents. ## Coming - More to read: delivery.