@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/youtube-api.json

@@ -18,7 +18,8 @@
       "oauth2"
     ],
     "headers": {
-      "Authorization": "Bearer {{token}}"
+      "Authorization": "Bearer {{token}}",
+      "Content-Type": "application/json"
     },
     "credential_fields": [
       {
@@ -56,7 +57,7 @@
       "pkce": false,
       "extra_authorize_params": {
         "access_type": "offline",
-        "prompt": "consent",
+        "prompt": "consent select_account",
         "include_granted_scopes": "true"
       }
     }
@@ -66,7 +67,7 @@
       "name": "get_my_channel",
       "description": "Get the authenticated user's YouTube channel info including subscriber count, video count, uploads playlist ID, branding, and description",
       "method": "GET",
-      "path": "/channels",
+      "path": "/channels?mine=true",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -75,9 +76,103 @@
             "description": "Comma-separated parts to include",
             "default": "snippet,contentDetails,statistics,brandingSettings"
           }
+        },
+        "required": [
+          "part"
+        ]
+      },
+      "mock_response": {
+        "kind": "youtube#channelListResponse",
+        "items": [
+          {
+            "kind": "youtube#channel",
+            "id": "UC0000000000000000000001",
+            "snippet": {
+              "title": "Apteva",
+              "description": "Continuous thinking engine",
+              "customUrl": "@apteva",
+              "publishedAt": "2024-01-01T00:00:00Z"
+            },
+            "statistics": {
+              "viewCount": "15234",
+              "subscriberCount": "842",
+              "hiddenSubscriberCount": false,
+              "videoCount": "27"
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 1
         }
       }
     },
+    {
+      "name": "query_analytics_report",
+      "description": "Query YouTube Analytics API reports for the authenticated channel. Use ids='channel==MINE', dimensions='day', and metrics such as views, estimatedMinutesWatched, subscribersGained, subscribersLost, likes, comments, shares for historical charts.",
+      "method": "GET",
+      "path": "https://youtubeanalytics.googleapis.com/v2/reports",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ids": {
+            "type": "string",
+            "description": "Report owner. Use channel==MINE for the authenticated channel.",
+            "default": "channel==MINE"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "Start date in YYYY-MM-DD format."
+          },
+          "endDate": {
+            "type": "string",
+            "description": "End date in YYYY-MM-DD format."
+          },
+          "metrics": {
+            "type": "string",
+            "description": "Comma-separated YouTube Analytics metrics.",
+            "default": "views,estimatedMinutesWatched,subscribersGained,subscribersLost,likes,comments,shares"
+          },
+          "dimensions": {
+            "type": "string",
+            "description": "Comma-separated dimensions. Use day for time-series charts.",
+            "default": "day"
+          },
+          "filters": {
+            "type": "string",
+            "description": "Optional report filters, for example video==VIDEO_ID."
+          },
+          "sort": {
+            "type": "string",
+            "description": "Optional sort expression.",
+            "default": "day"
+          },
+          "maxResults": {
+            "type": "integer",
+            "description": "Optional max rows to return."
+          },
+          "startIndex": {
+            "type": "integer",
+            "description": "Optional one-based row offset."
+          }
+        },
+        "required": ["ids", "startDate", "endDate", "metrics"]
+      },
+      "mock_response": {
+        "kind": "youtubeAnalytics#resultTable",
+        "columnHeaders": [
+          { "name": "day", "columnType": "DIMENSION", "dataType": "STRING" },
+          { "name": "views", "columnType": "METRIC", "dataType": "INTEGER" },
+          { "name": "estimatedMinutesWatched", "columnType": "METRIC", "dataType": "INTEGER" },
+          { "name": "subscribersGained", "columnType": "METRIC", "dataType": "INTEGER" }
+        ],
+        "rows": [
+          ["2026-05-20", 1200, 4300, 18],
+          ["2026-05-21", 1540, 5100, 22],
+          ["2026-05-22", 1425, 4890, 16]
+        ]
+      }
+    },
     {
       "name": "get_channel",
       "description": "Get detailed info about a YouTube channel by ID. Returns statistics (subscribers, views, videos), branding, description, and content details including uploads playlist ID",
@@ -97,15 +192,41 @@
           }
         },
         "required": [
-          "id"
+          "id",
+          "part"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#channelListResponse",
+        "items": [
+          {
+            "kind": "youtube#channel",
+            "id": "UC0000000000000000000002",
+            "snippet": {
+              "title": "Dev Channel",
+              "description": "Tutorials and demos",
+              "customUrl": "@devchannel",
+              "publishedAt": "2023-03-15T00:00:00Z"
+            },
+            "statistics": {
+              "viewCount": "982345",
+              "subscriberCount": "12400",
+              "hiddenSubscriberCount": false,
+              "videoCount": "210"
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 1
+        }
       }
     },
     {
       "name": "update_channel",
-      "description": "Update YouTube channel branding settings (title, description, keywords). Provide the full brandingSettings object.",
+      "description": "Update YouTube channel branding (the public 'About' description, title, keywords, country, etc.). ⚠️ DESTRUCTIVE OVERWRITE: this call overrides ALL mutable properties in brandingSettings.channel — any field you omit gets CLEARED. Safe pattern: first call get_my_channel with part='brandingSettings' to read current values, then send the full brandingSettings.channel object back with only the fields you want to change modified. Description max 1000 chars. Note: snippet.description is read-only via the API; the public 'About' description is brandingSettings.channel.description.",
       "method": "PUT",
-      "path": "/channels",
+      "path": "/channels?part=brandingSettings",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -115,19 +236,38 @@
           },
           "brandingSettings": {
             "type": "object",
-            "description": "Branding settings object with 'channel' sub-object containing title, description, keywords, etc.",
+            "description": "Full brandingSettings object. The 'channel' sub-object's mutable fields are title, description, keywords, country, defaultLanguage, unsubscribedTrailer, trackingAnalyticsAccountId. Omitted fields will be CLEARED — always merge over the current values returned by get_my_channel.",
             "properties": {
               "channel": {
                 "type": "object",
                 "properties": {
                   "title": {
-                    "type": "string"
+                    "type": "string",
+                    "description": "Channel title (max 100 chars)"
                   },
                   "description": {
-                    "type": "string"
+                    "type": "string",
+                    "description": "Public 'About' description shown on the channel page (max 1000 chars)"
                   },
                   "keywords": {
-                    "type": "string"
+                    "type": "string",
+                    "description": "Space-separated keywords (quote multi-word phrases)"
+                  },
+                  "country": {
+                    "type": "string",
+                    "description": "ISO 3166-1 alpha-2 country code (e.g. US, GB)"
+                  },
+                  "defaultLanguage": {
+                    "type": "string",
+                    "description": "BCP-47 language code (e.g. en, fr)"
+                  },
+                  "unsubscribedTrailer": {
+                    "type": "string",
+                    "description": "Video ID of the channel trailer for unsubscribed visitors"
+                  },
+                  "trackingAnalyticsAccountId": {
+                    "type": "string",
+                    "description": "Google Analytics tracking ID"
                   }
                 }
               }
@@ -138,13 +278,23 @@
           "id",
           "brandingSettings"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#channel",
+        "id": "UC0000000000000000000001",
+        "brandingSettings": {
+          "channel": {
+            "title": "Apteva",
+            "description": "Updated description"
+          }
+        }
       }
     },
     {
       "name": "search",
       "description": "Search for videos, channels, or playlists on YouTube. Supports filtering by duration, date range, channel, category, and sort order.",
       "method": "GET",
-      "path": "/search",
+      "path": "/search?part=snippet",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -218,13 +368,38 @@
         "required": [
           "q"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#searchListResponse",
+        "nextPageToken": "CAUQAA",
+        "regionCode": "US",
+        "pageInfo": {
+          "totalResults": 100000,
+          "resultsPerPage": 5
+        },
+        "items": [
+          {
+            "kind": "youtube#searchResult",
+            "id": {
+              "kind": "youtube#video",
+              "videoId": "dQw4w9WgXcQ"
+            },
+            "snippet": {
+              "publishedAt": "2026-05-20T12:00:00Z",
+              "channelId": "UC0000000000000000000002",
+              "title": "How to build agents",
+              "description": "A walkthrough of building autonomous agents.",
+              "channelTitle": "Dev Channel"
+            }
+          }
+        ]
       }
     },
     {
       "name": "get_trending",
       "description": "Get the most popular/trending videos on YouTube for a specific region",
       "method": "GET",
-      "path": "/videos",
+      "path": "/videos?chart=mostPopular&part=snippet,statistics,contentDetails",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -247,6 +422,34 @@
             "description": "Page token for pagination"
           }
         }
+      },
+      "mock_response": {
+        "kind": "youtube#videoListResponse",
+        "items": [
+          {
+            "kind": "youtube#video",
+            "id": "dQw4w9WgXcQ",
+            "snippet": {
+              "publishedAt": "2026-05-20T12:00:00Z",
+              "channelId": "UC0000000000000000000002",
+              "title": "How to build agents",
+              "channelTitle": "Dev Channel"
+            },
+            "statistics": {
+              "viewCount": "542310",
+              "likeCount": "32100",
+              "commentCount": "1870"
+            },
+            "contentDetails": {
+              "duration": "PT12M34S",
+              "definition": "hd"
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 1
+        }
       }
     },
     {
@@ -268,15 +471,52 @@
           }
         },
         "required": [
-          "id"
+          "id",
+          "part"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#videoListResponse",
+        "items": [
+          {
+            "kind": "youtube#video",
+            "id": "dQw4w9WgXcQ",
+            "snippet": {
+              "publishedAt": "2026-05-20T12:00:00Z",
+              "channelId": "UC0000000000000000000002",
+              "title": "How to build agents",
+              "description": "A walkthrough of building autonomous agents.",
+              "channelTitle": "Dev Channel",
+              "tags": [
+                "agents",
+                "ai"
+              ],
+              "categoryId": "28"
+            },
+            "statistics": {
+              "viewCount": "54231",
+              "likeCount": "3210",
+              "favoriteCount": "0",
+              "commentCount": "187"
+            },
+            "contentDetails": {
+              "duration": "PT12M34S",
+              "definition": "hd",
+              "caption": "false"
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 1
+        }
       }
     },
     {
       "name": "update_video",
       "description": "Update video metadata (title, description, tags, privacy, category, schedule). IMPORTANT: To schedule a video for future publish, you MUST set privacyStatus to 'private' AND provide publishAt as ISO 8601 datetime. Scheduling does NOT work with 'unlisted' or 'public' status \u2014 YouTube requires the video to be 'private' first. You must provide the full snippet and/or status objects.",
       "method": "PUT",
-      "path": "/videos",
+      "path": "/videos?part=snippet,status",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -349,6 +589,17 @@
         "required": [
           "id"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#video",
+        "id": "dQw4w9WgXcQ",
+        "snippet": {
+          "title": "Updated title",
+          "categoryId": "22"
+        },
+        "status": {
+          "privacyStatus": "public"
+        }
       }
     },
     {
@@ -367,13 +618,60 @@
         "required": [
           "id"
         ]
+      },
+      "mock_response": {
+        "success": true
+      }
+    },
+    {
+      "name": "upload_video_init",
+      "description": "Step 1 of YouTube's resumable video upload protocol. POSTs the video metadata (title, description, privacy, category) to the upload host and gets back a session URL in the Location response header. The caller (typically the social app's publishYoutube flow) then PUTs the actual video bytes to that session URL — that step does NOT go through this integration because Google's session URLs are pre-authorized (no Bearer header needed). Note: the path is absolute because YouTube's upload endpoint lives at googleapis.com/upload/youtube/v3, not the read API host.",
+      "method": "POST",
+      "path": "https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "snippet": {
+            "type": "object",
+            "description": "Video metadata. Required at minimum: title. Optional: description, tags, categoryId.",
+            "properties": {
+              "title": { "type": "string" },
+              "description": { "type": "string" },
+              "tags": { "type": "array", "items": { "type": "string" } },
+              "categoryId": {
+                "type": "string",
+                "description": "YouTube category ID. Defaults to 22 (People & Blogs) when omitted upstream."
+              }
+            },
+            "required": ["title"]
+          },
+          "status": {
+            "type": "object",
+            "description": "Privacy + license. privacyStatus is one of public, unlisted, private. Default 'private' for safety.",
+            "properties": {
+              "privacyStatus": {
+                "type": "string",
+                "enum": ["public", "unlisted", "private"],
+                "default": "private"
+              },
+              "selfDeclaredMadeForKids": { "type": "boolean" },
+              "embeddable": { "type": "boolean" }
+            }
+          }
+        },
+        "required": ["snippet"]
+      },
+      "mock_response": {
+        "upload_url": "https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status&upload_id=mock_upload_id_AbC123",
+        "upload_id": "mock_upload_id_AbC123",
+        "status": "initiated"
       }
     },
     {
       "name": "rate_video",
       "description": "Like, dislike, or remove rating from a YouTube video",
       "method": "POST",
-      "path": "/videos/rate",
+      "path": "/videos/rate?id={id}&rating={rating}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -395,81 +693,9 @@
           "id",
           "rating"
         ]
-      }
-    },
-    {
-      "name": "upload_video",
-      "description": "Upload a video to YouTube from a URL using resumable upload. Video is downloaded from the URL and uploaded to YouTube.",
-      "method": "POST",
-      "path": "/upload-video",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "videoUrl": {
-            "type": "string",
-            "description": "URL of the video file to upload"
-          },
-          "title": {
-            "type": "string",
-            "description": "Video title"
-          },
-          "description": {
-            "type": "string",
-            "description": "Video description"
-          },
-          "tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Video tags"
-          },
-          "categoryId": {
-            "type": "string",
-            "description": "Video category ID",
-            "default": "22"
-          },
-          "privacyStatus": {
-            "type": "string",
-            "enum": [
-              "private",
-              "public",
-              "unlisted"
-            ],
-            "default": "private"
-          },
-          "madeForKids": {
-            "type": "boolean",
-            "default": false
-          }
-        },
-        "required": [
-          "videoUrl",
-          "title"
-        ]
-      }
-    },
-    {
-      "name": "set_thumbnail",
-      "description": "Set a custom thumbnail for a YouTube video from an image URL",
-      "method": "GET",
-      "path": "/set-thumbnail",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "videoId": {
-            "type": "string",
-            "description": "YouTube video ID"
-          },
-          "thumbnailUrl": {
-            "type": "string",
-            "description": "URL of thumbnail image to upload"
-          }
-        },
-        "required": [
-          "videoId",
-          "thumbnailUrl"
-        ]
+      },
+      "mock_response": {
+        "success": true
       }
     },
     {
@@ -496,7 +722,36 @@
           "pageToken": {
             "type": "string",
             "description": "Page token for pagination"
+          },
+          "part": {
+            "type": "string",
+            "description": "Comma-separated parts to include",
+            "default": "snippet,contentDetails,status"
           }
+        },
+        "required": [
+          "part"
+        ]
+      },
+      "mock_response": {
+        "kind": "youtube#playlistListResponse",
+        "items": [
+          {
+            "kind": "youtube#playlist",
+            "id": "PL0000000000000000000001",
+            "snippet": {
+              "title": "Tutorials",
+              "channelId": "UC0000000000000000000001",
+              "publishedAt": "2025-06-01T00:00:00Z"
+            },
+            "contentDetails": {
+              "itemCount": 12
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 5
         }
       }
     },
@@ -519,15 +774,37 @@
           }
         },
         "required": [
-          "id"
+          "id",
+          "part"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#playlistListResponse",
+        "items": [
+          {
+            "kind": "youtube#playlist",
+            "id": "PL0000000000000000000001",
+            "snippet": {
+              "title": "Tutorials",
+              "channelId": "UC0000000000000000000001",
+              "publishedAt": "2025-06-01T00:00:00Z"
+            },
+            "contentDetails": {
+              "itemCount": 12
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 1
+        }
       }
     },
     {
       "name": "create_playlist",
       "description": "Create a new YouTube playlist",
       "method": "POST",
-      "path": "/playlists",
+      "path": "/playlists?part=snippet,status",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -567,13 +844,26 @@
         "required": [
           "snippet"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#playlist",
+        "id": "PL0000000000000000000099",
+        "snippet": {
+          "title": "New Playlist",
+          "description": "",
+          "publishedAt": "2026-05-22T12:00:00Z",
+          "channelId": "UC0000000000000000000001"
+        },
+        "status": {
+          "privacyStatus": "private"
+        }
       }
     },
     {
       "name": "update_playlist",
       "description": "Update a YouTube playlist's title, description, or privacy status",
       "method": "PUT",
-      "path": "/playlists",
+      "path": "/playlists?part=snippet,status",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -611,6 +901,17 @@
         "required": [
           "id"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#playlist",
+        "id": "PL0000000000000000000001",
+        "snippet": {
+          "title": "Updated Playlist",
+          "channelId": "UC0000000000000000000001"
+        },
+        "status": {
+          "privacyStatus": "public"
+        }
       }
     },
     {
@@ -629,6 +930,9 @@
         "required": [
           "id"
         ]
+      },
+      "mock_response": {
+        "success": true
       }
     },
     {
@@ -651,18 +955,46 @@
           "pageToken": {
             "type": "string",
             "description": "Page token for pagination"
+          },
+          "part": {
+            "type": "string",
+            "description": "Comma-separated parts to include",
+            "default": "snippet,contentDetails,status"
           }
         },
         "required": [
-          "playlistId"
+          "playlistId",
+          "part"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#playlistItemListResponse",
+        "items": [
+          {
+            "kind": "youtube#playlistItem",
+            "id": "UExtb2NrcGxheWxpc3RpdGVtMDAx",
+            "snippet": {
+              "title": "Episode 1",
+              "playlistId": "PL0000000000000000000001",
+              "position": 0,
+              "resourceId": {
+                "kind": "youtube#video",
+                "videoId": "dQw4w9WgXcQ"
+              }
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 50
+        }
       }
     },
     {
       "name": "add_to_playlist",
       "description": "Add a video to a YouTube playlist at an optional position",
       "method": "POST",
-      "path": "/playlistItems",
+      "path": "/playlistItems?part=snippet",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -705,6 +1037,18 @@
         "required": [
           "snippet"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#playlistItem",
+        "id": "UExtb2NrcGxheWxpc3RpdGVtMDk5",
+        "snippet": {
+          "playlistId": "PL0000000000000000000001",
+          "position": 0,
+          "resourceId": {
+            "kind": "youtube#video",
+            "videoId": "dQw4w9WgXcQ"
+          }
+        }
       }
     },
     {
@@ -723,6 +1067,9 @@
         "required": [
           "id"
         ]
+      },
+      "mock_response": {
+        "success": true
       }
     },
     {
@@ -754,18 +1101,49 @@
           "pageToken": {
             "type": "string",
             "description": "Page token for pagination"
+          },
+          "part": {
+            "type": "string",
+            "description": "Comma-separated parts to include",
+            "default": "snippet,replies"
           }
         },
         "required": [
-          "videoId"
+          "videoId",
+          "part"
         ]
+      },
+      "mock_response": {
+        "kind": "youtube#commentThreadListResponse",
+        "items": [
+          {
+            "kind": "youtube#commentThread",
+            "id": "Ugxmb2NrY29tbWVudHRocmVhZDAwMQ",
+            "snippet": {
+              "topLevelComment": {
+                "id": "Ugxmb2NrY29tbWVudDAwMQ",
+                "snippet": {
+                  "textDisplay": "Great video!",
+                  "authorDisplayName": "@viewer1",
+                  "likeCount": 5,
+                  "publishedAt": "2026-05-21T08:00:00Z"
+                }
+              },
+              "totalReplyCount": 1
+            }
+          }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 20
+        }
       }
     },
     {
       "name": "post_comment",
       "description": "Post a top-level comment on a YouTube video",
       "method": "POST",
-      "path": "/commentThreads",
+      "path": "/commentThreads?part=snippet",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -806,51 +1184,22 @@
         "required": [
           "snippet"
         ]
-      }
-    },
-    {
-      "name": "get_analytics",
-      "description": "Get YouTube Analytics data for your channel. Query views, watch time, subscribers, revenue, and more with date ranges and dimensions.\n\nCommon metrics: views, estimatedMinutesWatched, averageViewDuration, likes, comments, shares, subscribersGained, subscribersLost\n\nDimensions: day, month, video, country, ageGroup, gender",
-      "method": "GET",
-      "path": "/v2/reports",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "startDate": {
-            "type": "string",
-            "description": "Start date (YYYY-MM-DD)"
-          },
-          "endDate": {
-            "type": "string",
-            "description": "End date (YYYY-MM-DD)"
-          },
-          "metrics": {
-            "type": "string",
-            "description": "Comma-separated metrics",
-            "default": "views,estimatedMinutesWatched,averageViewDuration,likes,comments,shares"
-          },
-          "dimensions": {
-            "type": "string",
-            "description": "Dimension for grouping (e.g. day, video, country)"
-          },
-          "filters": {
-            "type": "string",
-            "description": "Filter expression (e.g. video==VIDEO_ID)"
-          },
-          "sort": {
-            "type": "string",
-            "description": "Sort order (e.g. -views for descending)"
+      },
+      "mock_response": {
+        "kind": "youtube#commentThread",
+        "id": "Ugxmb2NrY29tbWVudHRocmVhZDA5OQ",
+        "snippet": {
+          "topLevelComment": {
+            "id": "Ugxmb2NrY29tbWVudDA5OQ",
+            "snippet": {
+              "textDisplay": "(comment)",
+              "authorDisplayName": "Apteva",
+              "likeCount": 0,
+              "publishedAt": "2026-05-22T12:00:00Z"
+            }
           },
-          "maxResults": {
-            "type": "integer",
-            "description": "Max results",
-            "default": 25
-          }
-        },
-        "required": [
-          "startDate",
-          "endDate"
-        ]
+          "totalReplyCount": 0
+        }
       }
     },
     {
@@ -888,9 +1237,38 @@
           "pageToken": {
             "type": "string",
             "description": "Page token for pagination"
+          },
+          "part": {
+            "type": "string",
+            "description": "Comma-separated parts to include",
+            "default": "snippet,contentDetails"
+          }
+        },
+        "required": [
+          "part"
+        ]
+      },
+      "mock_response": {
+        "kind": "youtube#subscriptionListResponse",
+        "items": [
+          {
+            "kind": "youtube#subscription",
+            "id": "U1Vtb2Nrc3Vic2NyaXB0aW9uMDAx",
+            "snippet": {
+              "title": "Dev Channel",
+              "resourceId": {
+                "kind": "youtube#channel",
+                "channelId": "UC0000000000000000000002"
+              },
+              "publishedAt": "2025-09-01T00:00:00Z"
+            }
           }
+        ],
+        "pageInfo": {
+          "totalResults": 1,
+          "resultsPerPage": 50
         }
       }
     }
   ]
-}
+}