# Podsworth API

> Send podcast audio for processing from your own software. Create a project, upload its files (one PUT each) or import them, submit it, follow it (or get webhooks), download the cleaned-up audio, transcript and manifest, and copy it to process it again. Live keys spend the account's credits; test keys are simulated and free.

## Guides

- [Podsworth API](https://docs.podsworth.com/): Send podcast audio for processing from your own software.
- [Authentication](https://docs.podsworth.com/guides/authentication/): API keys, live and test mode, permissions, and what happens when people leave a team.
- [Quickstart](https://docs.podsworth.com/quickstart/): Create a test key, send a file, follow it and download the result, in curl, Python or TypeScript.
- [Projects](https://docs.podsworth.com/guides/projects/): The project lifecycle, multi-track projects, settings, changing a project, processing it again, rejections and outputs.
- [Files](https://docs.podsworth.com/guides/files/): Upload a file with one PUT, or have us import it from a URL, Dropbox or Google Drive, and use it in any project.
- [Keeping files](https://docs.podsworth.com/guides/keep/): Keep a project's files past 30 days for a credit fee, by default for a show or the whole account.
- [Sending to Drive and Dropbox](https://docs.podsworth.com/guides/delivery/): Destinations, sending a project's files when it completes, statuses, retries, and the events.
- [Test mode](https://docs.podsworth.com/guides/test-mode/): Run your whole integration with test keys: a simulator, forced failures, webhooks, no charges.
- [Webhooks](https://docs.podsworth.com/guides/webhooks/): Event types, the payload, verifying signatures, retries, testing an endpoint, and the events feed.
- [Errors and limits](https://docs.podsworth.com/guides/errors-and-limits/): Error responses and codes, rate limits, idempotent retries, pagination.
- [Credits](https://docs.podsworth.com/guides/credits/): How live projects are paid for, the balance and its history, and buying credits from the API.
- [Shows and usage](https://docs.podsworth.com/guides/shows/): A network's shows in one account, keys and webhooks limited to a show, defaults, and usage by show.
- [AI assistants (MCP)](https://docs.podsworth.com/guides/mcp/): Connect Claude or another MCP client to Podsworth: sign in once, choose what it may do, and let it send audio.

## Reference

- [OpenAPI file](https://docs.podsworth.com/openapi.json): every public endpoint and schema
- [All guides in one file](https://docs.podsworth.com/llms-full.txt)