API Documentation
Integrate OnAirFlow into your existing tools and workflows.
Note: The OnAirFlow API is currently in beta. Contact us for early access.
Authentication
All API requests require authentication using a Bearer token. Include your API key in the Authorization header:
Authorization: Bearer your_api_key_hereYou can generate API keys from your account settings.
Base URL
https://api.onairflow.com/v1Endpoints
GET
/api/showsList all shows for your organizationPOST
/api/showsCreate a new showGET
/api/shows/:idGet a specific show with its storiesPOST
/api/storiesCreate a new storyPATCH
/api/stories/:idUpdate a storyDELETE
/api/stories/:idDelete a storyExample Request
curl -X GET "https://api.onairflow.com/v1/shows" \ -H "Authorization: Bearer your_api_key_here" \ -H "Content-Type: application/json"
Example Response
{
"data": [
{
"id": "show_abc123",
"name": "Morning Edition",
"date": "2026-01-15T09:00:00Z",
"status": "scheduled",
"story_count": 12
}
],
"meta": {
"total": 1,
"page": 1,
"per_page": 20
}
}Rate Limits
API requests are limited based on your plan:
| Plan | Requests/minute | Requests/day |
|---|---|---|
| Free | 60 | 1,000 |
| Pro | 300 | 10,000 |
| Enterprise | Custom | Custom |