Castos API

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 your Jentic One instance 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.

Can I limit what my agent is allowed to do with the Castos API?

Yes. Because you run Jentic One yourself, your own rules decide which Castos operations and credentials the agent can use. Since the podcast id sits in the URL path, such as POST /podcasts/{podcast_id}/episodes, you can pin the agent to a single podcast for publishing episodes. You also choose the operations it may call, so private subscriber creation, revocation, and reactivation stay off limits unless you add them.