# PodcastSaaS

> API-first podcast hosting. Create podcasts, upload audio, and publish episodes programmatically over a REST API — built to be driven by AI agents.

This is the navigation index for agents and LLMs. Start with the full API reference, or fetch the OpenAPI spec for the machine-readable contract.

## Documentation

- [Full API reference (LLM-friendly)](https://tajhar.com/developers/llms.txt): Every endpoint with authentication, parameters, and request/response shapes, plus an end-to-end walkthrough for publishing an episode.
- [OpenAPI 3.1 spec (JSON)](https://tajhar.com/api/v1/openapi.json): Machine-readable API contract.
- [Interactive API reference](https://tajhar.com/developers): Human-friendly API explorer.

## API basics

- Base URL: `https://tajhar.com/api/v1`
- Auth: `Authorization: Bearer ptk_live_...` — create a token in the dashboard under Settings → API tokens.
- Format: JSON. Errors are `{ "error": { "code", "message" } }`. Lists are `{ "data": [...], "nextCursor": string | null }`.