Castos API
★ Only Publicly Available OpenAPI DocumentMediaAudio Processingbearer22 EndpointsREST
For Agents
Manage podcasts, episodes, and private subscribers on Castos, including bulk operations for invite-only feeds and reactivation of revoked subscribers.
Use for: I need to publish a new podcast episode to Castos, List all podcasts on my Castos account, Add a paying customer as a private subscriber to a Castos feed, Revoke a Castos subscriber when their membership lapses
Not supported: Does not handle audio recording, transcription, or listener analytics — use for managing Castos podcasts, episodes, and private subscribers only.
Jentic publishes the only available OpenAPI specification for Castos API, keeping it validated and agent-ready. Castos is a podcast hosting platform for creators and the v2 API exposes podcast and episode management together with private subscriber controls used by paid and members-only feeds. The API supports listing, creating, updating, and deleting podcasts and episodes, plus full lifecycle management of private subscribers including bulk create, update, revoke, and reactivate operations. It also returns the supported podcast category taxonomy used when classifying a show.
Install Jentic One Beta
Connect the Castos API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Castos API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Castos API.
Create, update, and delete podcasts hosted on a Castos account
Publish, edit, and remove individual episodes within a podcast
Add private subscribers to a podcast for paid or members-only feeds
Bulk create, update, and revoke private subscribers in a single API call
Look up a private subscriber by email or by subscriber id
Reactivate a revoked Castos private subscriber
Retrieve the Castos podcast category taxonomy for tagging shows
Use Cases
Patterns agents use Castos API for, with concrete tasks.
★ Membership-driven podcast access
Membership platforms can sync their paid subscribers into a Castos private feed using POST /private-subscribers and POST /create-private-subscribers for bulk imports. When a member cancels, POST /revoke-private-subscribers cuts feed access; reactivation endpoints restore it without re-collecting their email.
POST /create-private-subscribers with a list of 50 customer email addresses against podcast_id=42 to grant feed access in one batch.
Programmatic episode publishing
Production teams can post finished episodes to Castos using POST /podcasts/{podcast_id}/episodes with the audio URL, title, and show notes, then update metadata later via the corresponding update endpoint. This removes the manual step of uploading episodes via the Castos web UI for every release.
POST /podcasts/{podcast_id}/episodes with title, audio_url, and publish_at set to next Tuesday at 06:00 UTC.
Subscriber lifecycle management
Customer success workflows can keep Castos in sync with the source of truth by looking up a subscriber via GET /private-subscribers/email/{email_address}, then revoking, reactivating, or deleting based on billing status. Bulk endpoints make this efficient when running monthly reconciliation.
GET /private-subscribers/email/jane@example.com, then POST /private-subscribers/reactivate/email/jane@example.com if she has paid the outstanding invoice.
AI agent podcast operations via Jentic
An AI ops agent can take a list of new paid customers from a billing system and add them all to the right Castos private feed in one Jentic-driven call, with credentials kept inside the Jentic vault. The same agent can later trigger episode publication when a finished audio asset arrives.
Search Jentic for 'bulk create Castos private subscribers', load POST /create-private-subscribers, and execute it with the customer email batch.
Key Endpoints
22 endpoints — jentic publishes the only available openapi specification for castos api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/podcasts
List podcasts on the account
POST
/podcasts/{podcast_id}/episodes
Create a new episode
POST
/private-subscribers
Add a private subscriber to a podcast
POST
/create-private-subscribers
Bulk add private subscribers
POST
/revoke-private-subscribers
Bulk revoke private subscribers
POST
/private-subscribers/reactivate/email/{email_address}
Reactivate a subscription by email
GET
/get-categories
List supported podcast categories
GET
/podcasts
List podcasts on the account
POST
/podcasts/{podcast_id}/episodes
Create a new episode
POST
/private-subscribers
Add a private subscriber to a podcast
POST
/create-private-subscribers
Bulk add private subscribers
POST
/revoke-private-subscribers
Bulk revoke private subscribers
POST
/private-subscribers/reactivate/email/{email_address}
Reactivate a subscription by email
GET
/get-categories
List supported podcast categories
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Castos bearer API tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access at execution time and the token never enters prompts, logs, or response payloads.
Intent-based discovery
Agents search by intent (e.g., 'add a Castos private subscriber' or 'publish a podcast episode') and Jentic returns the matching operation along with its input schema, including the bulk variants.
Time to first call
Direct Castos integration including bulk subscriber handling and episode metadata: 1-2 days. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Castos API through Jentic.
Why is there no official OpenAPI spec for Castos API?
Castos publishes browsable docs but no machine-readable OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Castos API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Castos API use?
The Castos API uses HTTP bearer token authentication. You generate the API token from the Castos dashboard and include it as Authorization: Bearer in every request. Through Jentic the token is stored in the MAXsystem vault and injected at execution time, so it never appears in agent prompts.
Can I bulk add private subscribers to a Castos podcast?
Yes. POST /create-private-subscribers accepts a list of subscribers in a single request, and matching bulk endpoints exist for update (/update-private-subscribers) and revoke (/revoke-private-subscribers). Use these instead of looping over the per-subscriber endpoint when syncing membership lists.
What are the rate limits for the Castos API?
Castos does not document explicit numeric rate limits in this OpenAPI spec. Prefer the bulk private-subscriber endpoints over per-record loops, and avoid tight polling on /podcasts and /podcasts/{podcast_id}/episodes — use scheduled syncs instead.
How do I reactivate a cancelled Castos subscriber?
Call POST /private-subscribers/reactivate/{subscriber_id} if you know the subscriber id, or POST /private-subscribers/reactivate/email/{email_address} to reactivate by email. This restores feed access without requiring the subscriber to re-enter their email.
How do I publish a Castos episode through Jentic?
Run pip install jentic, search Jentic with the query 'publish a podcast episode to Castos', load the POST /podcasts/{podcast_id}/episodes schema, and execute it with title, audio_url, and an optional publish_at timestamp. Jentic handles the bearer token automatically.
GET STARTED