01
POST /agentAsk the booking agent
Send a DJ-specific question in plain language. Get a grounded answer, structured effects, persistent memory, and an undo receipt.
Connecting to Greenroom
Connecting to Greenroom
DJ booking intelligence, with an API
Greenroom gives developers access to a persistent agent built for DJ booking. It can answer artist-specific questions, reason over authorized Greenroom context, and make supported changes. The raw booking API is there when you need the controls.
The Agent API
The Greenroom agent is trained and tested around DJ work: fees, markets, promoter fit, travel, availability, outreach, and show operations. It keeps a private thread for each DJ and only sees context authorized by that account.
Your app gets the answer and a separate effects object. If the agent remembered a preference, changed a profile, or added a trip, the response says so plainly.
Your app asks
“Which Berlin promoters fit my sound, and why?”
POST /api/v1/agentGreenroom returns
Try the live API
This panel calls the same public search endpoint your software can use. Change the terms, run the request, and inspect the JSON without creating a key.
/api/v1/searchRequest path
/api/v1/search?types=dj%2Cvenue&limit=4&q=techno&city=BerlinRun the request to see a live response.Core capabilities
POST /agentSend a DJ-specific question in plain language. Get a grounded answer, structured effects, persistent memory, and an undo receipt.
GET /searchFind public DJ profiles and sourced venues across one catalog. Filter by city, genre, or the words people actually use.
POST /matchesTurn a promoter event brief into a ranked DJ list with fit scores and readable reasons.
REST + webhooksCreate calendar holds, advance production, track introductions, and keep invoices beside the booking.
What can I make?
Start with one job that currently lives in a spreadsheet, inbox, or group chat. The API gives that job structured data and safe actions.
For artist teams
Build route planners, availability widgets, advancing checklists, private dashboards, or a small app for the crew.
For promoters
Publish opportunities, rank artists against a real event brief, manage introductions, and move confirmed shows into operations.
For scene products
Create city guides, venue maps, artist directories, lineup research tools, and community products from privacy-safe public data.
For AI products
Call the Agent API or connect the Greenroom MCP so a DJ can ask about fees, rooms, routing, outreach, and profile changes in plain words.
One agent turn
POST /agentSend the DJ's booking question.Authorized contextUse their profile, memory, calendar, and network.reply + payloadReturn booking judgment and useful cards.effectsApply only supported profile, memory, or calendar changes.receiptShow exactly what changed and keep undo available.Reliable writes
Idempotency keys prevent a dropped connection from creating the same event, invoice, opportunity, or calendar hold twice.
Visible failures
Stable error codes, rate information, and request IDs make production problems easier to trace.
Permission boundaries
Keys inherit an account role. OAuth grants calendar-only access with S256 PKCE. Public search returns privacy-safe fields.
Start with the contract