> 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/start-here/ai-agents/mcp-reference/public-object-schemas.md).

# Public object schemas

Summary of the main public object shapes returned by Podigee MCP tools.

Exact JSON Schemas are published on each tool page. These are the shared semantic objects.

## Account identity

User ID, email, locale, tenant ID, effective write availability, server write availability, scopes, and authentication method.

## Podcast

Numeric ID, title, subtitle, subdomain, language, publication type, publication time, protection, timestamps, public metadata, feed URL, artwork, categories, feed item count, encoding quality, and transcription setting.

## Episode

Numeric ID, podcast ID, editorial metadata, publication type and time, media presence, production ID, duration, links, artwork, labels, keywords, chapter marks, and transcript availability.

## Transcript segment

Optional start and end seconds, text, and speaker ID. Transcript pages preserve stored order.

## Content asset

Numeric ID, type, editorial status, title, source podcast and optional episode, generation status, timestamps, and full body on detail reads.

## Production

Numeric ID, episode ID, state, status, optional job ID, timestamps, and encoded time.

## Durable operation

UUID, type, state, stage, retryability, attempts, related resource IDs, result, error, timestamps, and optional import progress.

## Listener

Numeric ID, podcast ID, email or username, status, optional expiry, and timestamps. Passwords, access tokens, and private feed URLs are not returned.

## Distribution

Show connections use stable platform keys, normalized states, submission flags, listing URL, and manual-handoff indicator. Episode delivery reports per-platform state, delivered flag, media type, remote URL, error, sync time, and retry guidance when available.


---

# 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/start-here/ai-agents/mcp-reference/public-object-schemas.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.