> 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-tools/manage-workspace.md).

# manage\_workspace

Reference for the \`manage\_workspace\` MCP tool.

Inspect a workspace or preview and apply one podcast create or update.

## Contract

| Property                     | Value                                     |
| ---------------------------- | ----------------------------------------- |
| Required scopes              | `mcp:podcasts:read`, `mcp:podcasts:write` |
| Read-only                    | `false`                                   |
| Destructive                  | `true`                                    |
| Idempotent                   | `true`                                    |
| May interact outside Podigee | `true`                                    |

The MCP annotations describe client behavior. The server still applies authorization, validation, preview, confirmation, ownership, and account boundaries at execution time.

## Example request

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manage_workspace",
    "arguments": {
      "podcast_id": 42,
      "list_episodes": true
    }
  }
}
```

The example uses placeholder IDs. Replace them with IDs returned for the connected account.

## Input schema

The structural schema below omits prose `description` fields so each line remains readable. The complete public descriptions follow the schema.

```json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "podcast_id": {
      "type": "integer"
    },
    "create_attributes": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "authors": {
          "type": "string"
        },
        "category_id": {
          "type": "integer"
        },
        "category_ids": {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        "copyright_text": {
          "type": "string"
        },
        "cover_image": {
          "type": "string",
          "format": "uri"
        },
        "create_stats_reports": {
          "type": "boolean"
        },
        "domain": {
          "type": "string"
        },
        "explicit": {
          "type": "boolean"
        },
        "external_site_url": {
          "type": "string",
          "format": "uri"
        },
        "facebook": {
          "type": "string"
        },
        "feed_items": {
          "type": "integer"
        },
        "flattr_id": {
          "type": "string"
        },
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "language": {
          "type": "string"
        },
        "owner_email": {
          "type": "string"
        },
        "publication_type": {
          "type": "string"
        },
        "quality": {
          "type": "string"
        },
        "subdomain": {
          "type": "string"
        },
        "subtitle": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "transcriptions_enabled": {
          "type": "boolean"
        },
        "twitter": {
          "type": "string"
        },
        "website_url": {
          "type": "string",
          "format": "uri"
        },
        "blog_attributes": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "external_site_url": {
              "type": "string",
              "format": "uri"
            },
            "domain": {
              "type": "string"
            },
            "analytics_code": {
              "type": "string"
            }
          }
        },
        "external": {
          "type": "boolean"
        }
      }
    },
    "update_attributes": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "authors": {
          "type": "string"
        },
        "category_id": {
          "type": "integer"
        },
        "category_ids": {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        "copyright_text": {
          "type": "string"
        },
        "cover_image": {
          "type": "string",
          "format": "uri"
        },
        "create_stats_reports": {
          "type": "boolean"
        },
        "domain": {
          "type": "string"
        },
        "explicit": {
          "type": "boolean"
        },
        "external_site_url": {
          "type": "string",
          "format": "uri"
        },
        "facebook": {
          "type": "string"
        },
        "feed_items": {
          "type": "integer"
        },
        "flattr_id": {
          "type": "string"
        },
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "language": {
          "type": "string"
        },
        "owner_email": {
          "type": "string"
        },
        "publication_type": {
          "type": "string"
        },
        "quality": {
          "type": "string"
        },
        "subdomain": {
          "type": "string"
        },
        "subtitle": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "transcriptions_enabled": {
          "type": "boolean"
        },
        "twitter": {
          "type": "string"
        },
        "website_url": {
          "type": "string",
          "format": "uri"
        },
        "blog_attributes": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "external_site_url": {
              "type": "string",
              "format": "uri"
            },
            "domain": {
              "type": "string"
            },
            "analytics_code": {
              "type": "string"
            }
          }
        },
        "published_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "list_episodes": {
      "type": "boolean"
    },
    "dry_run": {
      "type": "boolean"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "confirm": {
      "type": "string",
      "minLength": 1
    }
  },
  "oneOf": [
    {
      "type": "object",
      "required": [],
      "additionalProperties": false,
      "properties": {
        "podcast_id": {
          "type": "integer"
        },
        "list_episodes": {
          "type": "boolean"
        },
        "dry_run": {
          "type": "boolean"
        }
      }
    },
    {
      "type": "object",
      "required": [
        "create_attributes",
        "dry_run"
      ],
      "additionalProperties": false,
      "properties": {
        "list_episodes": {
          "type": "boolean"
        },
        "create_attributes": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "authors": {
              "type": "string"
            },
            "category_id": {
              "type": "integer"
            },
            "category_ids": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            },
            "copyright_text": {
              "type": "string"
            },
            "cover_image": {
              "type": "string",
              "format": "uri"
            },
            "create_stats_reports": {
              "type": "boolean"
            },
            "domain": {
              "type": "string"
            },
            "explicit": {
              "type": "boolean"
            },
            "external_site_url": {
              "type": "string",
              "format": "uri"
            },
            "facebook": {
              "type": "string"
            },
            "feed_items": {
              "type": "integer"
            },
            "flattr_id": {
              "type": "string"
            },
            "keywords": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "language": {
              "type": "string"
            },
            "owner_email": {
              "type": "string"
            },
            "publication_type": {
              "type": "string"
            },
            "quality": {
              "type": "string"
            },
            "subdomain": {
              "type": "string"
            },
            "subtitle": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "transcriptions_enabled": {
              "type": "boolean"
            },
            "twitter": {
              "type": "string"
            },
            "website_url": {
              "type": "string",
              "format": "uri"
            },
            "blog_attributes": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "external_site_url": {
                  "type": "string",
                  "format": "uri"
                },
                "domain": {
                  "type": "string"
                },
                "analytics_code": {
                  "type": "string"
                }
              }
            },
            "external": {
              "type": "boolean"
            }
          }
        },
        "dry_run": {
          "const": true
        },
        "idempotency_key": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        }
      }
    },
    {
      "type": "object",
      "required": [
        "create_attributes",
        "idempotency_key",
        "confirm"
      ],
      "additionalProperties": false,
      "properties": {
        "list_episodes": {
          "type": "boolean"
        },
        "create_attributes": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "authors": {
              "type": "string"
            },
            "category_id": {
              "type": "integer"
            },
            "category_ids": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            },
            "copyright_text": {
              "type": "string"
            },
            "cover_image": {
              "type": "string",
              "format": "uri"
            },
            "create_stats_reports": {
              "type": "boolean"
            },
            "domain": {
              "type": "string"
            },
            "explicit": {
              "type": "boolean"
            },
            "external_site_url": {
              "type": "string",
              "format": "uri"
            },
            "facebook": {
              "type": "string"
            },
            "feed_items": {
              "type": "integer"
            },
            "flattr_id": {
              "type": "string"
            },
            "keywords": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "language": {
              "type": "string"
            },
            "owner_email": {
              "type": "string"
            },
            "publication_type": {
              "type": "string"
            },
            "quality": {
              "type": "string"
            },
            "subdomain": {
              "type": "string"
            },
            "subtitle": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "transcriptions_enabled": {
              "type": "boolean"
            },
            "twitter": {
              "type": "string"
            },
            "website_url": {
              "type": "string",
              "format": "uri"
            },
            "blog_attributes": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "external_site_url": {
                  "type": "string",
                  "format": "uri"
                },
                "domain": {
                  "type": "string"
                },
                "analytics_code": {
                  "type": "string"
                }
              }
            },
            "external": {
              "type": "boolean"
            }
          }
        },
        "dry_run": {
          "const": false
        },
        "idempotency_key": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "confirm": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    {
      "type": "object",
      "required": [
        "podcast_id",
        "update_attributes",
        "dry_run"
      ],
      "additionalProperties": false,
      "properties": {
        "list_episodes": {
          "type": "boolean"
        },
        "podcast_id": {
          "type": "integer"
        },
        "update_attributes": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "authors": {
              "type": "string"
            },
            "category_id": {
              "type": "integer"
            },
            "category_ids": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            },
            "copyright_text": {
              "type": "string"
            },
            "cover_image": {
              "type": "string",
              "format": "uri"
            },
            "create_stats_reports": {
              "type": "boolean"
            },
            "domain": {
              "type": "string"
            },
            "explicit": {
              "type": "boolean"
            },
            "external_site_url": {
              "type": "string",
              "format": "uri"
            },
            "facebook": {
              "type": "string"
            },
            "feed_items": {
              "type": "integer"
            },
            "flattr_id": {
              "type": "string"
            },
            "keywords": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "language": {
              "type": "string"
            },
            "owner_email": {
              "type": "string"
            },
            "publication_type": {
              "type": "string"
            },
            "quality": {
              "type": "string"
            },
            "subdomain": {
              "type": "string"
            },
            "subtitle": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "transcriptions_enabled": {
              "type": "boolean"
            },
            "twitter": {
              "type": "string"
            },
            "website_url": {
              "type": "string",
              "format": "uri"
            },
            "blog_attributes": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "external_site_url": {
                  "type": "string",
                  "format": "uri"
                },
                "domain": {
                  "type": "string"
                },
                "analytics_code": {
                  "type": "string"
                }
              }
            },
            "published_at": {
              "type": "string",
              "format": "date-time"
            }
          }
        },
        "dry_run": {
          "const": true
        },
        "idempotency_key": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        }
      }
    },
    {
      "type": "object",
      "required": [
        "podcast_id",
        "update_attributes",
        "idempotency_key",
        "confirm"
      ],
      "additionalProperties": false,
      "properties": {
        "list_episodes": {
          "type": "boolean"
        },
        "podcast_id": {
          "type": "integer"
        },
        "update_attributes": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "authors": {
              "type": "string"
            },
            "category_id": {
              "type": "integer"
            },
            "category_ids": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            },
            "copyright_text": {
              "type": "string"
            },
            "cover_image": {
              "type": "string",
              "format": "uri"
            },
            "create_stats_reports": {
              "type": "boolean"
            },
            "domain": {
              "type": "string"
            },
            "explicit": {
              "type": "boolean"
            },
            "external_site_url": {
              "type": "string",
              "format": "uri"
            },
            "facebook": {
              "type": "string"
            },
            "feed_items": {
              "type": "integer"
            },
            "flattr_id": {
              "type": "string"
            },
            "keywords": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "language": {
              "type": "string"
            },
            "owner_email": {
              "type": "string"
            },
            "publication_type": {
              "type": "string"
            },
            "quality": {
              "type": "string"
            },
            "subdomain": {
              "type": "string"
            },
            "subtitle": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "transcriptions_enabled": {
              "type": "boolean"
            },
            "twitter": {
              "type": "string"
            },
            "website_url": {
              "type": "string",
              "format": "uri"
            },
            "blog_attributes": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "external_site_url": {
                  "type": "string",
                  "format": "uri"
                },
                "domain": {
                  "type": "string"
                },
                "analytics_code": {
                  "type": "string"
                }
              }
            },
            "published_at": {
              "type": "string",
              "format": "date-time"
            }
          }
        },
        "dry_run": {
          "const": false
        },
        "idempotency_key": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "confirm": {
          "type": "string",
          "minLength": 1
        }
      }
    }
  ]
}
```

### Input field descriptions

No additional field descriptions are defined.

### Key constraints

* `idempotency_key` has minimum length 1 and maximum length 255.
* `confirm` has minimum length 1.
* `request` requires: `create_attributes`, `dry_run`.
* `request` requires: `create_attributes`, `idempotency_key`, `confirm`.
* `request` requires: `podcast_id`, `update_attributes`, `dry_run`.
* `request` requires: `podcast_id`, `update_attributes`, `idempotency_key`, `confirm`.

## Output schema

The `structuredContent` object in a successful tool result matches this schema.

The structural schema below omits prose `description` fields. The complete public descriptions follow the schema.

```json
{
  "type": "object",
  "required": [
    "account",
    "podcasts",
    "podcast",
    "episodes",
    "next_recommended_workflow"
  ],
  "additionalProperties": false,
  "properties": {
    "account": {
      "type": "object",
      "required": [
        "id",
        "email"
      ],
      "additionalProperties": false,
      "properties": {
        "id": {
          "type": "integer"
        },
        "email": {
          "type": "string"
        }
      }
    },
    "podcasts": {
      "type": "object",
      "required": [
        "podcasts",
        "pagination"
      ],
      "additionalProperties": false,
      "properties": {
        "podcasts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id"
            ],
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "integer"
              },
              "title": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "subtitle": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "subdomain": {
                "type": "string"
              },
              "language": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "publication_type": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "published_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "protected": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "created_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "updated_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            }
          }
        },
        "pagination": {
          "type": "object",
          "required": [
            "total",
            "limit",
            "offset"
          ],
          "additionalProperties": false,
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 0
            },
            "limit": {
              "type": "integer",
              "minimum": 1
            },
            "offset": {
              "type": "integer",
              "minimum": 0
            },
            "next_offset": {
              "type": "integer",
              "minimum": 0
            }
          }
        }
      }
    },
    "podcast": {
      "anyOf": [
        {
          "type": "object",
          "oneOf": [
            {
              "type": "object",
              "required": [
                "id"
              ],
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "integer"
                },
                "title": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "subtitle": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "subdomain": {
                  "type": "string"
                },
                "language": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "publication_type": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "published_at": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "protected": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "created_at": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "updated_at": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "authors": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "website_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "explicit": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "quality": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "enum": [
                    "low",
                    "high",
                    "super_high",
                    "ice_portal_compatible_audio",
                    null
                  ]
                },
                "keywords": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "feed_items": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "copyright_text": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "owner_email": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "ad_free_feed": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "transcriptions_enabled": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "feed_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "cover_image_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "category_ids": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              }
            },
            {
              "type": "object",
              "required": [
                "dry_run",
                "action",
                "attributes",
                "request_digest",
                "confirm"
              ],
              "additionalProperties": false,
              "properties": {
                "dry_run": {
                  "const": true
                },
                "action": {
                  "const": "create_podcast"
                },
                "attributes": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "authors": {
                      "type": "string"
                    },
                    "category_id": {
                      "type": "integer"
                    },
                    "category_ids": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    },
                    "copyright_text": {
                      "type": "string"
                    },
                    "cover_image": {
                      "type": "string",
                      "format": "uri"
                    },
                    "create_stats_reports": {
                      "type": "boolean"
                    },
                    "domain": {
                      "type": "string"
                    },
                    "explicit": {
                      "type": "boolean"
                    },
                    "external_site_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "facebook": {
                      "type": "string"
                    },
                    "feed_items": {
                      "type": "integer"
                    },
                    "flattr_id": {
                      "type": "string"
                    },
                    "keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "language": {
                      "type": "string"
                    },
                    "owner_email": {
                      "type": "string"
                    },
                    "publication_type": {
                      "type": "string"
                    },
                    "quality": {
                      "type": "string"
                    },
                    "subdomain": {
                      "type": "string"
                    },
                    "subtitle": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "transcriptions_enabled": {
                      "type": "boolean"
                    },
                    "twitter": {
                      "type": "string"
                    },
                    "website_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "blog_attributes": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "external_site_url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "domain": {
                          "type": "string"
                        },
                        "analytics_code": {
                          "type": "string"
                        }
                      }
                    },
                    "external": {
                      "type": "boolean"
                    }
                  }
                },
                "request_digest": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                "confirm": {
                  "type": "string",
                  "minLength": 1
                }
              }
            },
            {
              "type": "object",
              "required": [
                "dry_run",
                "action",
                "attributes",
                "request_digest",
                "confirm",
                "podcast_id"
              ],
              "additionalProperties": false,
              "properties": {
                "dry_run": {
                  "const": true
                },
                "action": {
                  "const": "update_podcast"
                },
                "attributes": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "authors": {
                      "type": "string"
                    },
                    "category_id": {
                      "type": "integer"
                    },
                    "category_ids": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    },
                    "copyright_text": {
                      "type": "string"
                    },
                    "cover_image": {
                      "type": "string",
                      "format": "uri"
                    },
                    "create_stats_reports": {
                      "type": "boolean"
                    },
                    "domain": {
                      "type": "string"
                    },
                    "explicit": {
                      "type": "boolean"
                    },
                    "external_site_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "facebook": {
                      "type": "string"
                    },
                    "feed_items": {
                      "type": "integer"
                    },
                    "flattr_id": {
                      "type": "string"
                    },
                    "keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "language": {
                      "type": "string"
                    },
                    "owner_email": {
                      "type": "string"
                    },
                    "publication_type": {
                      "type": "string"
                    },
                    "quality": {
                      "type": "string"
                    },
                    "subdomain": {
                      "type": "string"
                    },
                    "subtitle": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "transcriptions_enabled": {
                      "type": "boolean"
                    },
                    "twitter": {
                      "type": "string"
                    },
                    "website_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "blog_attributes": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "external_site_url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "domain": {
                          "type": "string"
                        },
                        "analytics_code": {
                          "type": "string"
                        }
                      }
                    },
                    "published_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                },
                "request_digest": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                "confirm": {
                  "type": "string",
                  "minLength": 1
                },
                "podcast_id": {
                  "type": "integer"
                }
              }
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "episodes": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "episodes",
            "pagination"
          ],
          "additionalProperties": false,
          "properties": {
            "episodes": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "id",
                  "podcast_id"
                ],
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "podcast_id": {
                    "type": "integer"
                  },
                  "title": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "subtitle": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "number": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "season": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "publication_type": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "published_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "explicit": {
                    "anyOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "has_media": {
                    "type": "boolean"
                  },
                  "created_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "updated_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                }
              }
            },
            "pagination": {
              "type": "object",
              "required": [
                "total",
                "limit",
                "offset"
              ],
              "additionalProperties": false,
              "properties": {
                "total": {
                  "type": "integer",
                  "minimum": 0
                },
                "limit": {
                  "type": "integer",
                  "minimum": 1
                },
                "offset": {
                  "type": "integer",
                  "minimum": 0
                },
                "next_offset": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "next_recommended_workflow": {
      "type": "string",
      "enum": [
        "publish_episode",
        "manage_workspace"
      ]
    }
  }
}
```

### Output field descriptions

### `podcast (anyOf 1) (oneOf 1).quality`

The audio encoding profile new media is encoded to. It says nothing about the editorial or production quality of the show, and "low" is not a problem to report to the user.

### `podcast (anyOf 1) (oneOf 1).feed_items`

How many of the most recent episodes the RSS feed lists at once. Older episodes stay reachable through paged feeds, so this is not the number of episodes the podcast has.

### `episodes (anyOf 1).episodes[].has_media`

Whether playable audio or video is attached. An episode with has\_media false cannot be published: publish\_episode rejects it, and setting published\_at on it produces a dated episode that never goes out. Attach media first.

## Safety and retries

Use `dry_run: true` to inspect the normalized plan before any consequential change. When the preview requires confirmation, repeat the same request with the exact returned `confirm` value before it expires. Reuse one stable `idempotency_key` for retries of the same intended action. Use a new key for a different action.

Do not retry validation, authorization, plan, or ownership errors unchanged. Retry transient errors only when the response marks them as retryable. For durable work, use the returned operation ID instead of starting the same action again.

## Related guides

* [Inspect or prepare a workspace in one guided flow](/documentation/start-here/ai-agents/manage-podcasts/inspect-or-prepare-a-workspace-in-one-guided-flow.md)


---

# 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-tools/manage-workspace.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.