> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/connect-and-administer/integrations/rest-api.md).

# REST API

Reference collection for the Podigee hosting REST API v1, first request, errors, and endpoints.

Use this collection when you build your own integration with the Podigee hosting REST API v1. The API is available at `https://app.podigee.com/api/v1` and uses JSON for every request and response.

The API Reference space of this site documents a different interface. This collection is the reference for the Podigee hosting REST API v1.

## Start here

* [Make your first API request](/documentation/connect-and-administer/integrations/rest-api/make-your-first-api-request.md): get a credential, list your podcasts, and open the interactive API docs.
* [REST API authentication and errors](/documentation/connect-and-administer/integrations/rest-api/rest-api-authentication-and-errors.md): credentials, the error body, read-only tokens, and the rate-limit response.

## Endpoint groups

* [REST API podcasts and episodes](/documentation/connect-and-administer/integrations/rest-api/rest-api-podcasts-and-episodes.md)
* [REST API media uploads and encoding](/documentation/connect-and-administer/integrations/rest-api/rest-api-media-uploads-and-encoding.md)
* [REST API episode content](/documentation/connect-and-administer/integrations/rest-api/rest-api-episode-content.md): chapter marks, contributors, text snippets, intro and outro audio, transcript imports
* [REST API listeners](/documentation/connect-and-administer/integrations/rest-api/rest-api-listeners.md): private feed listeners
* [REST API analytics](/documentation/connect-and-administer/integrations/rest-api/rest-api-analytics.md)
* [REST API account](/documentation/connect-and-administer/integrations/rest-api/rest-api-account.md): the `me` endpoint

## Conventions used on these pages

* Paths are relative to `https://app.podigee.com/api/v1`.
* The API is available on Scale and above, or on an older plan that includes it. The Analytics endpoints have the same gate.
* Podigee sends no outbound webhooks. Poll the endpoints to detect changes.
* The interactive API docs at `https://app.podigee.com/api-docs` show the request and response schemas of every published endpoint.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podigee.com/documentation/connect-and-administer/integrations/rest-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.