> 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/resume-operation.md).

# resume\_operation

Reference for the \`resume\_operation\` MCP tool.

Preview, then resume a retryable durable MCP operation.

## Contract

| Property                     | Value                                |
| ---------------------------- | ------------------------------------ |
| Required scopes              | Depends on the stored operation type |
| Read-only                    | `false`                              |
| Destructive                  | `true`                               |
| Idempotent                   | `false`                              |
| 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": "resume_operation",
    "arguments": {
      "operation_id": "123e4567-e89b-12d3-a456-426614174001",
      "dry_run": 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",
  "required": [
    "operation_id",
    "dry_run"
  ],
  "additionalProperties": false,
  "properties": {
    "operation_id": {
      "type": "string",
      "format": "uuid"
    },
    "dry_run": {
      "type": "boolean"
    },
    "confirm": {
      "type": "string",
      "minLength": 1
    }
  }
}
```

### Input field descriptions

No additional field descriptions are defined.

### Key constraints

* `request` requires: `operation_id`, `dry_run`.
* `confirm` has minimum length 1.

## 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",
  "oneOf": [
    {
      "type": "object",
      "required": [
        "dry_run",
        "action",
        "operation_id",
        "operation",
        "request_digest",
        "confirm"
      ],
      "additionalProperties": false,
      "properties": {
        "dry_run": {
          "const": true
        },
        "action": {
          "const": "resume_operation"
        },
        "operation_id": {
          "type": "string",
          "format": "uuid"
        },
        "operation": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "id",
            "operation_type",
            "state",
            "stage",
            "retryable",
            "attempts"
          ],
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "operation_type": {
              "type": "string"
            },
            "state": {
              "type": "string",
              "enum": [
                "queued",
                "running",
                "waiting",
                "succeeded",
                "failed_retryable",
                "failed_terminal",
                "cancelled"
              ]
            },
            "stage": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "podcast_id": {
              "type": "integer"
            },
            "episode_id": {
              "type": "integer"
            },
            "production_id": {
              "type": "integer"
            },
            "podcast_import_id": {
              "type": "integer"
            },
            "listener_id": {
              "type": "integer"
            },
            "attempts": {
              "type": "integer"
            },
            "result": {
              "oneOf": [
                {
                  "type": "object",
                  "maxProperties": 0,
                  "additionalProperties": false,
                  "properties": {}
                },
                {
                  "type": "object",
                  "required": [
                    "reset_record_id"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "reset_record_id": {
                      "type": "integer"
                    },
                    "delivery_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "delivery_committed_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "delivery_sent_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "episode_id"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "episode_id": {
                      "type": "integer"
                    },
                    "production_id": {
                      "type": "integer"
                    },
                    "publication_mode": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "now",
                        "scheduled"
                      ]
                    },
                    "published_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "podcast_import_id",
                    "imported_episode_ids"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "podcast_import_id": {
                      "type": "integer"
                    },
                    "podcast_id": {
                      "type": "integer"
                    },
                    "imported_episode_ids": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "operation_id",
                    "listener_id",
                    "reset_email_sent",
                    "listener"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "operation_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "listener_id": {
                      "type": "integer"
                    },
                    "reset_email_sent": {
                      "const": true
                    },
                    "listener": {
                      "type": "object",
                      "required": [
                        "id",
                        "podcast_id",
                        "status",
                        "created_at",
                        "updated_at"
                      ],
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "podcast_id": {
                          "type": "integer"
                        },
                        "email": {
                          "type": "string"
                        },
                        "username": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "active",
                            "inactive",
                            "resent"
                          ]
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "created_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updated_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "anyOf": [
                        {
                          "required": [
                            "email"
                          ]
                        },
                        {
                          "required": [
                            "username"
                          ]
                        }
                      ]
                    }
                  }
                },
                {
                  "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": [
                    "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"
                        }
                      ]
                    },
                    "show_notes": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "show_notes_md": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "authors": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "guid": {
                      "type": "string"
                    },
                    "external_url": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "keywords": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "labels": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "bypass_ad_insertion": {
                      "type": "boolean"
                    },
                    "ad_provider": {
                      "anyOf": [
                        {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "intro_outro_include": {
                      "anyOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "video_content_rating": {
                      "type": "string"
                    },
                    "video_thumbnail_source": {
                      "type": "string"
                    },
                    "production_id": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "duration": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "permalink": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "cover_image_url": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "chapter_marks": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [],
                            "additionalProperties": false,
                            "properties": {
                              "title": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "start_time": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "url": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "transcription": {
                      "type": "object",
                      "required": [
                        "available",
                        "segment_count"
                      ],
                      "additionalProperties": false,
                      "properties": {
                        "available": {
                          "type": "boolean"
                        },
                        "segment_count": {
                          "type": "integer"
                        },
                        "updated_at": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      }
                    }
                  }
                }
              ]
            },
            "error": {
              "oneOf": [
                {
                  "type": "object",
                  "maxProperties": 0,
                  "additionalProperties": false,
                  "properties": {}
                },
                {
                  "type": "object",
                  "minProperties": 1,
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "error_type": {
                      "type": "string"
                    },
                    "error_class": {
                      "type": "string"
                    },
                    "error_message": {
                      "type": "string"
                    },
                    "occurred_at": {
                      "type": "string"
                    },
                    "failed_at": {
                      "type": "string"
                    },
                    "job_id": {
                      "type": "string"
                    },
                    "retry_count": {
                      "type": "integer"
                    },
                    "source_feed_title": {
                      "type": "string"
                    },
                    "imported_to_existing": {
                      "type": "boolean"
                    },
                    "skipped_episode_guids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "manual_retry_count": {
                      "type": "integer"
                    },
                    "failed_episode_guid": {
                      "type": "string"
                    },
                    "pause_count": {
                      "type": "integer"
                    },
                    "paused": {
                      "type": "boolean"
                    },
                    "failed_episode_title": {
                      "type": "string"
                    },
                    "failed_episode_number": {
                      "type": "integer"
                    },
                    "failed_media_url": {
                      "type": "string"
                    },
                    "connection_results": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "setup": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "skipped": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              ]
            },
            "created_at": {
              "type": "string",
              "format": "date-time"
            },
            "updated_at": {
              "type": "string",
              "format": "date-time"
            },
            "started_at": {
              "type": "string",
              "format": "date-time"
            },
            "completed_at": {
              "type": "string",
              "format": "date-time"
            },
            "failed_at": {
              "type": "string",
              "format": "date-time"
            },
            "cancelled_at": {
              "type": "string",
              "format": "date-time"
            },
            "progress": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "current",
                "total",
                "percent"
              ],
              "properties": {
                "current": {
                  "type": "integer"
                },
                "total": {
                  "type": "integer"
                },
                "percent": {
                  "type": "integer"
                },
                "current_episode_title": {
                  "type": "string"
                },
                "current_episode_number": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "request_digest": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "confirm": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "operation_type",
        "state",
        "stage",
        "retryable",
        "attempts"
      ],
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "operation_type": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "enum": [
            "queued",
            "running",
            "waiting",
            "succeeded",
            "failed_retryable",
            "failed_terminal",
            "cancelled"
          ]
        },
        "stage": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        },
        "podcast_id": {
          "type": "integer"
        },
        "episode_id": {
          "type": "integer"
        },
        "production_id": {
          "type": "integer"
        },
        "podcast_import_id": {
          "type": "integer"
        },
        "listener_id": {
          "type": "integer"
        },
        "attempts": {
          "type": "integer"
        },
        "result": {
          "oneOf": [
            {
              "type": "object",
              "maxProperties": 0,
              "additionalProperties": false,
              "properties": {}
            },
            {
              "type": "object",
              "required": [
                "reset_record_id"
              ],
              "additionalProperties": false,
              "properties": {
                "reset_record_id": {
                  "type": "integer"
                },
                "delivery_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "delivery_committed_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "delivery_sent_at": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "episode_id"
              ],
              "additionalProperties": false,
              "properties": {
                "episode_id": {
                  "type": "integer"
                },
                "production_id": {
                  "type": "integer"
                },
                "publication_mode": {
                  "type": "string",
                  "enum": [
                    "draft",
                    "now",
                    "scheduled"
                  ]
                },
                "published_at": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "podcast_import_id",
                "imported_episode_ids"
              ],
              "additionalProperties": false,
              "properties": {
                "podcast_import_id": {
                  "type": "integer"
                },
                "podcast_id": {
                  "type": "integer"
                },
                "imported_episode_ids": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "operation_id",
                "listener_id",
                "reset_email_sent",
                "listener"
              ],
              "additionalProperties": false,
              "properties": {
                "operation_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "listener_id": {
                  "type": "integer"
                },
                "reset_email_sent": {
                  "const": true
                },
                "listener": {
                  "type": "object",
                  "required": [
                    "id",
                    "podcast_id",
                    "status",
                    "created_at",
                    "updated_at"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "podcast_id": {
                      "type": "integer"
                    },
                    "email": {
                      "type": "string"
                    },
                    "username": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "pending",
                        "active",
                        "inactive",
                        "resent"
                      ]
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  },
                  "anyOf": [
                    {
                      "required": [
                        "email"
                      ]
                    },
                    {
                      "required": [
                        "username"
                      ]
                    }
                  ]
                }
              }
            },
            {
              "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": [
                "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"
                    }
                  ]
                },
                "show_notes": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "show_notes_md": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "authors": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "guid": {
                  "type": "string"
                },
                "external_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "keywords": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "labels": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "bypass_ad_insertion": {
                  "type": "boolean"
                },
                "ad_provider": {
                  "anyOf": [
                    {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "string"
                        }
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "intro_outro_include": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "video_content_rating": {
                  "type": "string"
                },
                "video_thumbnail_source": {
                  "type": "string"
                },
                "production_id": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "duration": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "permalink": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "cover_image_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "chapter_marks": {
                  "anyOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [],
                        "additionalProperties": false,
                        "properties": {
                          "title": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "start_time": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        }
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "transcription": {
                  "type": "object",
                  "required": [
                    "available",
                    "segment_count"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "available": {
                      "type": "boolean"
                    },
                    "segment_count": {
                      "type": "integer"
                    },
                    "updated_at": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                }
              }
            }
          ]
        },
        "error": {
          "oneOf": [
            {
              "type": "object",
              "maxProperties": 0,
              "additionalProperties": false,
              "properties": {}
            },
            {
              "type": "object",
              "minProperties": 1,
              "additionalProperties": false,
              "properties": {
                "code": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                },
                "error_type": {
                  "type": "string"
                },
                "error_class": {
                  "type": "string"
                },
                "error_message": {
                  "type": "string"
                },
                "occurred_at": {
                  "type": "string"
                },
                "failed_at": {
                  "type": "string"
                },
                "job_id": {
                  "type": "string"
                },
                "retry_count": {
                  "type": "integer"
                },
                "source_feed_title": {
                  "type": "string"
                },
                "imported_to_existing": {
                  "type": "boolean"
                },
                "skipped_episode_guids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "manual_retry_count": {
                  "type": "integer"
                },
                "failed_episode_guid": {
                  "type": "string"
                },
                "pause_count": {
                  "type": "integer"
                },
                "paused": {
                  "type": "boolean"
                },
                "failed_episode_title": {
                  "type": "string"
                },
                "failed_episode_number": {
                  "type": "integer"
                },
                "failed_media_url": {
                  "type": "string"
                },
                "connection_results": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "setup": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "skipped": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          ]
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time"
        },
        "started_at": {
          "type": "string",
          "format": "date-time"
        },
        "completed_at": {
          "type": "string",
          "format": "date-time"
        },
        "failed_at": {
          "type": "string",
          "format": "date-time"
        },
        "cancelled_at": {
          "type": "string",
          "format": "date-time"
        },
        "progress": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "current",
            "total",
            "percent"
          ],
          "properties": {
            "current": {
              "type": "integer"
            },
            "total": {
              "type": "integer"
            },
            "percent": {
              "type": "integer"
            },
            "current_episode_title": {
              "type": "string"
            },
            "current_episode_number": {
              "type": "integer"
            }
          }
        }
      }
    }
  ]
}
```

### Output field descriptions

### `(oneOf 1).operation.result (oneOf 6).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.

### `(oneOf 1).operation.result (oneOf 6).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.

### `(oneOf 1).operation.result (oneOf 7).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.

### `(oneOf 1).operation.progress`

Per-episode progress for long-running imports. Absent when the operation does not track item-level progress yet.

### `(oneOf 2).result (oneOf 6).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.

### `(oneOf 2).result (oneOf 6).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.

### `(oneOf 2).result (oneOf 7).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.

### `(oneOf 2).progress`

Per-episode progress for long-running imports. Absent when the operation does not track item-level progress yet.

## 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. Authorization is resolved from the stored operation type. The caller needs the matching read or write scope for that operation.

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

* [Resume or cancel an operation](/documentation/start-here/ai-agents/make-changes-safely/resume-or-cancel-an-operation.md)
* [Recover after a disconnect or reauthorization](/documentation/start-here/ai-agents/make-changes-safely/recover-after-a-disconnect-or-reauthorization.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/resume-operation.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.