{
    "variable": [
        {
            "id": "baseUrl",
            "key": "baseUrl",
            "type": "string",
            "name": "string",
            "value": "https:\/\/studio.upstream.so"
        }
    ],
    "info": {
        "name": "Upstream.so API",
        "_postman_id": "9bc88a44-278a-427b-a62d-4a676b02db51",
        "description": "The Upstream.so API lets you create and run streams, manage your media library, and multistream to every platform \u2014 straight from your own code.",
        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json",
        "version": "1.0.0"
    },
    "item": [
        {
            "name": "Account",
            "description": "",
            "item": [
                {
                    "name": "Get the authenticated user",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/user",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/user"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the account that owns the API token used for this request."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d571-a085-4f5d-8c90-25b117fccbe6\",\"name\":\"Morgan Hirthe\",\"email\":\"dare.emelie@example.com\",\"created_at\":\"2026-11-18T19:51:31+00:00\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Streams",
            "description": "",
            "item": [
                {
                    "name": "List YouTube connections",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/youtube-connections",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/youtube-connections"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns YouTube channels connected in Studio for the authenticated account.\nUse the returned `id` as `youtube_connection_id` when creating a scheduled stream."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":[{\"id\":\"8a79e29e-f5d2-4ea9-99f2-1fa5c45ec03b\",\"channel_id\":\"UCexample\",\"channel_name\":\"My channel\",\"channel_thumbnail\":null}]}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"Acting as another account is not supported on the API.\"}",
                            "name": "Acting as another account"
                        }
                    ]
                },
                {
                    "name": "List streams",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams",
                            "query": [
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to return. Defaults to 1.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "15",
                                    "description": "Number of streams per page (1\u2013100). Defaults to 15.",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/streams?page=1&per_page=15"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the streams owned by the authenticated account, paginated. Response\nfields are documented on the \"Get a stream\" endpoint (same resource shape)."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":[{\"id\":\"a341d572-46ce-4f94-9110-ab7f5e571779\",\"name\":\"Morgan Hirthe\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"active\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:32+00:00\",\"updated_at\":\"2026-11-18T19:51:32+00:00\"},{\"id\":\"a341d573-02a9-4fe5-9257-a21b86bee8e9\",\"name\":\"Juliet King\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"active\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:32+00:00\",\"updated_at\":\"2026-11-18T19:51:32+00:00\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"path\":\"\\\/\",\"per_page\":15,\"to\":2,\"total\":2}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        }
                    ]
                },
                {
                    "name": "Create a stream",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"My 24\\\/7 Lofi Stream\",\"description\":\"Relaxing beats, all day.\",\"platform\":\"youtube\",\"type\":\"video\",\"key\":\"abcd-efgh-ijkl-mnop-qrst\",\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":30,\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":\"fade\",\"animation_duration\":1},\"video_fit\":{\"object_fit\":\"cover\",\"style\":\"blur\",\"background_color\":\"#000000\"},\"schedule\":{\"is_scheduled\":false,\"is_scheduled_end\":false,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"preserve_state\":false},\"recording\":{\"enabled\":false},\"website_player\":{\"allowed_websites\":[\"architecto\"]},\"tags\":[\"n\"]}"
                        },
                        "description": "Creates a stream owned by the authenticated account. Manual destinations require\na `key`. With `platform: youtube`, use `youtube_connection_id` from List YouTube\nconnections. Omit `key` and `url`. Choose a manual, one-time, recurring, or continuous\nschedule. For manual or one-time streams, choose `youtube_event_mode` of `immediate`\nor `on_start`. One-time streams default to immediate, and the other schedule types\ndefault to on_start. `data.youtube.watch_url` is null until the event is created.\nFor manual control, omit `schedule`. For recurrence, set `schedule.repeat_schedule`\nto true and choose daily or weekly via `schedule.repeat_frequency`. Recurring loop\nplayback defaults to a one-hour run if you omit the end time and end flag.\nFor back-to-back\ncycles, set `schedule.mode` to continuous and choose the cycle duration, break duration,\nand stop policy. A continuous start of now queues the first run with the scheduler.\nUse `youtube_privacy_status: public` for a public Upcoming listing.\nReplace the example dates with your show's times:\n\n```json\n{\n  \"name\": \"Special live show\",\n  \"platform\": \"youtube\",\n  \"youtube_connection_id\": \"8a79e29e-f5d2-4ea9-99f2-1fa5c45ec03b\",\n  \"youtube_privacy_status\": \"public\",\n  \"schedule\": {\n    \"scheduled_at\": \"2030-01-01T18:00:00Z\",\n    \"scheduled_end_at\": \"2030-01-01T19:00:00Z\"\n  },\n  \"idempotency_key\": \"ce9872c1-e9b7-4db7-8119-acace334e690\"\n}\n```\n\nSettings groups\n(volumes, playback, transitions, video_fit, schedule, recording) are optional and\ndefault sensibly when omitted.\n`status` is managed by the start\/stop endpoints and cannot be set here. Returns `201 Created`."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\"data\":{\"id\":\"a341d573-dfdb-40eb-bc37-0d858e88310c\",\"name\":\"Ramiro Okuneva\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"installing\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:33+00:00\",\"updated_at\":\"2026-11-18T19:51:33+00:00\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\"data\": {\"platform\": \"youtube\", \"youtube\": {\"connection_id\": \"8a79e29e-f5d2-4ea9-99f2-1fa5c45ec03b\", \"broadcast_id\": \"sampleVideo\", \"watch_url\": \"https:\/\/www.youtube.com\/watch?v=sampleVideo\", \"privacy_status\": \"public\"}}}",
                            "name": "YouTube Connect excerpt"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"Stream limit reached (3). Upgrade your plan to add more streams.\"}",
                            "name": "Stream limit reached"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"You have reached your limit of 10 saved streams. Delete an existing stream or upgrade your plan to create another.\"}",
                            "name": "Saved stream limit reached"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"You've used up your streaming time. Upgrade your plan to keep streaming.\"}",
                            "name": "Streaming access exhausted"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"Acting as another account is not supported on the API.\"}",
                            "name": "Acting as another account"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"code\": \"youtube_create_unresolved\", \"message\": \"Check Upstream and YouTube Studio before creating another event.\", \"retryable\": false}",
                            "name": "Earlier create attempt needs attention"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The key field is required.\", \"errors\": {\"key\": [\"The key field is required.\"]}}",
                            "name": "Validation failed"
                        },
                        {
                            "header": [],
                            "code": 424,
                            "body": "{\"code\": \"youtube_reconnect_required\", \"message\": \"Reconnect the selected YouTube channel in Upstream Studio.\", \"retryable\": false}",
                            "name": "YouTube connection needs attention"
                        }
                    ]
                },
                {
                    "name": "Get a stream",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns a single stream owned by the authenticated account."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d574-97c8-41cc-a46b-c7e528d7db4a\",\"name\":\"Morgan Hirthe\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"active\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:33+00:00\",\"updated_at\":\"2026-11-18T19:51:33+00:00\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        }
                    ]
                },
                {
                    "name": "Update a stream",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "PATCH",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"My 24\\\/7 Lofi Stream\",\"description\":\"Relaxing beats, all day.\",\"platform\":\"youtube\",\"key\":\"abcd-efgh-ijkl-mnop-qrst\",\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":30,\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":\"fade\",\"animation_duration\":1},\"video_fit\":{\"object_fit\":\"cover\",\"style\":\"blur\",\"background_color\":\"#000000\"},\"schedule\":{\"is_scheduled\":false,\"is_scheduled_end\":false,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"preserve_state\":false},\"recording\":{\"enabled\":false},\"website_player\":{\"allowed_websites\":[\"architecto\"]},\"tags\":[\"n\"]}"
                        },
                        "description": "Partially updates a stream owned by the authenticated account \u2014 send only the\nfields you want to change (nested settings objects are merged, not replaced).\n`status` is managed by the start\/stop endpoints and cannot be changed here, and\nmultistream destinations are managed via the Multistreaming endpoints."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d575-5a7c-4ec0-a85f-a3a1afd2314d\",\"name\":\"Ramiro Okuneva\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"active\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:34+00:00\",\"updated_at\":\"2026-11-18T19:51:34+00:00\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The selected encoding.resolution is invalid.\", \"errors\": {\"encoding.resolution\": [\"The selected encoding.resolution is invalid.\"]}}",
                            "name": "Validation failed"
                        }
                    ]
                },
                {
                    "name": "Delete a stream",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Permanently deletes a stream owned by the authenticated account (stops any live\nbroadcast and tears down associated resources). Returns an empty 204 response.\nUpstream queues YouTube cleanup after deletion. For an Upcoming event created\nwith the stream, cleanup cancels the event before removing its ingest.\nYouTube recordings are preserved. To set up the next show, update the stream's\nname and schedule."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Deleted"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        }
                    ]
                },
                {
                    "name": "Start a stream",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/start",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/start",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"resume\":true}"
                        },
                        "description": "Starts a stream owned by the authenticated account \u2014 moves it into the `booting`\nstate, after which the platform brings it live (status becomes `active` on its own).\nIdempotent: starting a stream that is already booting or active returns 200 with the\ncurrent stream and makes no change. A started stream can still pause, for example when\nYouTube refuses the broadcast: read the stream after about a minute and check\n`paused_reason` before you start it again. Send `resume: true` to start at the stream's\n`resume_point` instead of the start of the video playlist."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d576-275e-4ee0-9a24-921951ccdc6e\",\"name\":\"Morgan Hirthe\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"booting\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:34+00:00\",\"updated_at\":\"2026-11-18T19:51:34+00:00\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"You've used up your streaming time. Upgrade your plan to keep streaming.\"}",
                            "name": "Plan has no streaming access"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\": \"Stream cannot be started from its current state (installing).\"}",
                            "name": "Not startable from current state"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\": \"Stream was just stopped; wait a few seconds before starting it again.\"}",
                            "name": "Restart cooldown"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"Add a streaming destination before starting this stream.\"}",
                            "name": "No configured destination"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"There is no stopped position to resume from.\", \"errors\": {\"resume\": [\"There is no stopped position to resume from.\"]}}",
                            "name": "Nothing to resume"
                        },
                        {
                            "header": [],
                            "code": 429,
                            "body": "{\"message\": \"YouTube is limiting requests from this YouTube account. Upstream will try to start this stream automatically after 10:15 UTC. You do not need to press Start again.\", \"code\": \"youtube_rate_limited\", \"retryable\": false, \"retry_after_seconds\": 540, \"auto_start_until\": \"2026-11-03T11:05:00+00:00\", \"next_step\": \"Do not call start again. Upstream tries to start this stream on its own after retry_after_seconds, and keeps trying until auto_start_until. Read the stream after that to see whether it started.\"}",
                            "name": "YouTube is limiting requests from the stream's YouTube account; Upstream tries to start the stream on its own"
                        }
                    ]
                },
                {
                    "name": "Stop a stream",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/stop",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/stop",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Stops a stream owned by the authenticated account \u2014 moves it back into the `paused`\nstate and ends the current browser publishing session. Stopping an already\npaused stream returns 200 with the current stream and clears any pending\nbrowser session or YouTube automatic start retry."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d576-e26e-4b74-b9ff-2142cab78a59\",\"name\":\"Morgan Hirthe\",\"description\":null,\"platform\":\"youtube\",\"type\":\"video\",\"url\":\"dQw4w9WgXcQ\",\"status\":\"paused\",\"paused_reason\":null,\"paused_message\":null,\"youtube_retry_until\":null,\"thumbnail_url\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/dQw4w9WgXcQ\\\/maxresdefault.jpg\",\"tags\":[\"lofi\",\"chill\"],\"encoding\":{\"resolution\":\"1920x1080\",\"frame_rate\":\"30\",\"bitrate\":8000,\"audio_bitrate\":128},\"volumes\":{\"main\":70,\"secondary\":30,\"video\":100},\"playback\":{\"mode\":\"loop\",\"video_order\":\"loop\",\"audio_order\":\"loop\",\"default_image_duration\":10},\"transitions\":{\"fade_duration\":2,\"animation_type\":null,\"animation_duration\":null},\"video_fit\":{\"object_fit\":null,\"style\":null,\"background_color\":null},\"schedule\":{\"is_scheduled\":false,\"scheduled_at\":null,\"is_scheduled_end\":false,\"scheduled_end_at\":null,\"repeat_schedule\":false,\"repeat_frequency\":\"daily\",\"mode\":null,\"continuous_start_type\":null,\"continuous_stop_type\":null,\"continuous_stop_at\":null,\"continuous_stop_after_cycles\":null,\"continuous_cycle_count\":0,\"stream_duration_hours\":null,\"stream_duration_minutes\":null,\"break_duration_hours\":null,\"break_duration_minutes\":null,\"preserve_state\":false,\"will_auto_start\":false},\"recording\":{\"enabled\":false},\"website_player\":null,\"multistream_destinations\":[],\"started_at\":null,\"resume_point\":null,\"created_at\":\"2026-11-18T19:51:35+00:00\",\"updated_at\":\"2026-11-18T19:51:35+00:00\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\": \"Stream cannot be stopped from its current state (installing).\"}",
                            "name": "Not stoppable from current state"
                        }
                    ]
                },
                {
                    "name": "Set up the RTMP source",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/source\/rtmp",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/source\/rtmp",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Selects the default RTMP input on a paused stream with no existing Studio\nsource configuration. Returns current credentials if the default RTMP input\nis already the only selected source, even while streaming. Repeating the\nrequest does not rotate the key or take a different Studio scene on air.\nFor an input already set up in Studio, use the RTMP credentials endpoint\nto retrieve its key without changing the scene.\n\nUse a full API key. After creating a stream, wait for its status to be `paused`\nbefore calling this endpoint. Keep the returned publishing key on your server.\nConfigure your destinations, start the stream in Upstream, then publish from\nyour encoder."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"url\":\"rtmp:\/\/ingest.example.test\/live\",\"stream_key\":\"example-publish-key\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\":\"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\":\"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\":\"This stream already has a Studio source configuration. Set up RTMP on a stream without an existing Studio program.\"}",
                            "name": "Source setup conflicts with existing configuration"
                        },
                        {
                            "header": [],
                            "code": 503,
                            "body": "{\"message\":\"Could not prepare the RTMP source. Try again.\"}",
                            "name": "RTMP setup temporarily unavailable"
                        }
                    ]
                },
                {
                    "name": "Get existing RTMP credentials",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/source\/rtmp\/credentials",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/source\/rtmp\/credentials",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Reads the stream's default RTMP input, including an input created in\nLive Studio. This call never provisions an input or changes its key,\nStudio sources, or stream status. Use a full API key from your server."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"url\":\"rtmp:\/\/ingest.example.test\/live\",\"stream_key\":\"example-publish-key\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\":\"Unauthenticated.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"This action is unauthorized.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\":\"This stream has no available RTMP input.\"}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Prepare a browser camera source",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/source\/browser",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/source\/browser",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns a LiveKit connection URL and a short-lived token for publishing\ncamera and microphone to the stream's main encoder input. Your backend\ncalls this endpoint with a full API key and sends only the returned\nconnection data to your browser. The token is for one stream room.\n\nStart with a paused stream. If there is no Studio source configuration,\nUpstream makes the main encoder the program source. If the main encoder\nis already in the program, Upstream keeps its scenes and layout. An\nexisting program that excludes it must be updated in Studio first.\n\nConfigure destinations, then start the stream through the API. In your\nbrowser, connect to LiveKit with `url` and `token` and publish camera and\nmicrophone. The token is valid for the initial connection for two minutes.\nRequest a fresh token if it expires before you connect. An attached input\ncan also issue tokens while the stream is booting or active.\nWith the `livekit-client` package, call the following from your Go Live\nflow after your backend returns the connection data:\n\n```js\nimport { Room } from 'livekit-client';\n\nconst room = new Room();\nawait room.connect(url, token, { autoSubscribe: false });\nawait room.localParticipant.enableCameraAndMicrophone();\n```\n\nThe main input uses one browser publisher at a time. A camera connection\ncan replace an earlier browser connection in the same session. If an RTMP\nor WHIP encoder is delivering video, it takes priority in the program.\nWhen the broadcast ends, disconnect the LiveKit room and stop the Upstream\nstream through the API. A later broadcast needs fresh connection data."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"url\":\"wss:\/\/livekit.example.test\",\"token\":\"example-browser-publisher-token\",\"expires_in\":120}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\":\"Unauthenticated.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"This action is unauthorized.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\":\"Resource not found.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\":\"Add the main encoder input to the current Studio program before publishing from your browser.\"}",
                            "name": "Main encoder is outside the Studio program"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\":\"Stop the active encoder before publishing from your browser.\"}",
                            "name": "Main encoder is already publishing"
                        },
                        {
                            "header": [],
                            "code": 503,
                            "body": "{\"message\":\"Could not prepare the browser source. Try again.\"}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "List a stream's media queue",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/queues\/:type",
                            "query": [
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to return. Defaults to 1.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "15",
                                    "description": "Number of items per page (1\u2013100). Defaults to 15.",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/queues\/:type?page=1&per_page=15",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "type",
                                    "key": "type",
                                    "value": "video",
                                    "description": "The queue to read: video, audio, audio-secondary, or external-videos."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns one of a stream's playback queues, paginated and in playback order. The\n`type` segment selects the queue:\n\n- `video` \u2014 the video\/image queue (`selected_videos`)\n- `audio` \u2014 the primary audio queue (`selected_audios`)\n- `audio-secondary` \u2014 the secondary audio queue (`selected_audios_secondary`)\n- `external-videos` \u2014 externally-hosted videos (`selected_external_videos`)\n\nThe first three return Storage-backed media items (identity + metadata; media file\nURLs are intentionally omitted). `external-videos` returns the inline external items,\nincluding the source `url` and nullable `duration` in seconds, which may appear shortly after adding. An unknown `type` returns 404.\n\nWithin a Storage-backed queue, any entry that no longer resolves \u2014 deleted media,\nmedia still processing, or a file-type mismatch \u2014 is omitted, so the list reflects\nexactly what would play."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"name\": \"intro.mp4\", \"file_type\": \"video\", \"extension\": \"mp4\", \"duration\": 42.5, \"size\": 10485760, \"title\": null, \"artist\": null, \"album\": null, \"year\": null, \"genre\": null}], \"links\": {\"first\": \"...\", \"last\": \"...\", \"prev\": null, \"next\": null}, \"meta\": {\"current_page\": 1, \"last_page\": 1, \"per_page\": 15, \"total\": 1, \"from\": 1, \"to\": 1}}",
                            "name": "Video queue"
                        },
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"65a1f3c0d4e2b\", \"name\": \"Promo\", \"url\": \"https:\/\/example.com\/promo.mp4\", \"file_type\": \"video\", \"thumbnail\": null, \"duration\": null}], \"links\": {\"first\": \"...\", \"last\": \"...\", \"prev\": null, \"next\": null}, \"meta\": {\"current_page\": 1, \"last_page\": 1, \"per_page\": 15, \"total\": 1, \"from\": 1, \"to\": 1}}",
                            "name": "External video queue"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream or queue type not found"
                        }
                    ]
                },
                {
                    "name": "Add items to a media queue",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/queues\/:type",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/queues\/:type",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "type",
                                    "key": "type",
                                    "value": "video",
                                    "description": "The queue: video, audio, audio-secondary, or external-videos."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"items\":[\"6ff8f7f6-1eb3-3525-be4a-3932c805afed\"]}"
                        },
                        "description": "Appends items to a queue, in order, at the end. For the Storage-backed queues\n(`video`, `audio`, `audio-secondary`) `items` is a list of your own media UUIDs of the\nqueue's type \u2014 still-processing media is accepted (it shows once ready) but failed media\nis rejected; if any id is unavailable the whole request is rejected (422). For\n`external-videos`, `items` is a list of `{url, name}` objects (`.mp4` URLs). An id\/URL\nalready in the queue is skipped \u2014 a queue holds each item at most once. Returns the\nupdated queue."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"name\": \"intro.mp4\", \"file_type\": \"video\", \"extension\": \"mp4\", \"duration\": 42.5, \"size\": 10485760, \"title\": null, \"artist\": null, \"album\": null, \"year\": null, \"genre\": null}]}",
                            "name": "Updated Storage-backed queue"
                        },
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"name\": \"Promo\", \"url\": \"https:\/\/example.com\/promo.mp4\", \"file_type\": \"video\", \"thumbnail\": null, \"duration\": null}]}",
                            "name": "Updated external-videos queue"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"This media is not available for this queue.\", \"errors\": {\"items.0\": [\"This media is not available for this queue.\"]}}",
                            "name": "An id is unavailable"
                        }
                    ]
                },
                {
                    "name": "Remove an item from a media queue",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/queues\/:type\/:mediaId",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/queues\/:type\/:mediaId",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "type",
                                    "key": "type",
                                    "value": "video",
                                    "description": "The queue: video, audio, audio-secondary, or external-videos."
                                },
                                {
                                    "id": "mediaId",
                                    "key": "mediaId",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The id of the item to remove \u2014 a media UUID for the Storage-backed queues, or the external-video item id for external-videos."
                                }
                            ]
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Removes an item from a queue by its id \u2014 a media UUID for the Storage-backed queues, or\nthe inline item id for external-videos. Returns the updated queue, or 404 if that id\nisn't currently in the queue."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": []}",
                            "name": "Updated queue"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found or item not in queue"
                        }
                    ]
                },
                {
                    "name": "Reorder a media queue",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/queues\/:type\/reorder",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/queues\/:type\/reorder",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "type",
                                    "key": "type",
                                    "value": "video",
                                    "description": "The queue: video, audio, audio-secondary, or external-videos."
                                }
                            ]
                        },
                        "method": "PATCH",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"order\":[\"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\"]}"
                        },
                        "description": "Sets the playback order of a queue (Storage-backed or external-videos). `order` must\ncontain exactly the ids currently visible in the queue \u2014 reorder only reorders; use the\nadd\/remove endpoints to change membership. Returns the reordered queue."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"name\": \"intro.mp4\", \"file_type\": \"video\", \"extension\": \"mp4\", \"duration\": 42.5, \"size\": 10485760, \"title\": null, \"artist\": null, \"album\": null, \"year\": null, \"genre\": null}]}",
                            "name": "Reordered queue"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The order must contain exactly the items currently in the queue.\", \"errors\": {\"order\": [\"The order must contain exactly the items currently in the queue.\"]}}",
                            "name": "Order isn't the current set"
                        }
                    ]
                },
                {
                    "name": "Skip the current queue item",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/queues\/:type\/skip",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/queues\/:type\/skip",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "type",
                                    "key": "type",
                                    "value": "video",
                                    "description": "The queue: video, audio, or external-videos."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Immediately requests the next item without restarting the livestream. The player\nfollows its current playback order (including shuffle) and playback mode. In loop\nmode the last item wraps to the beginning; in single mode skipping the last item\ncompletes the playlist as usual. `video` and `external-videos` control the same\nvideo player, whose playlist combines uploaded and external videos.\n\nRequires an active stream with playable items. Live controls support primary audio,\nuploaded videos\/images and external videos; secondary audio, radio and direct streams\nare not supported. Commands are delivered asynchronously. A 202 acknowledges the\nrequest, not confirmed playback or frame-accurate scheduling. Play\/skip requests share\na limit of one command per second per audio\/video player with Studio's Play now."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 202,
                            "body": "{\"data\": {\"stream_id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"queue\": \"video\", \"action\": \"skip\"}, \"message\": \"Playback request accepted.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\": \"Playback can only be controlled while the stream is active.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 429,
                            "body": "{\"message\": \"Play requests can only be sent once every 1 second per type.\"}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Play a specific queue item now",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/queues\/:type\/play",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/queues\/:type\/play",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "type",
                                    "key": "type",
                                    "value": "audio",
                                    "description": "The queue: video, audio, or external-videos."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"item_id\":\"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\",\"position_seconds\":90}"
                        },
                        "description": "Requests an immediate jump to `item_id`, starting it from the beginning or, for video\nqueues, from `position_seconds`, without restarting the livestream or changing queue\nmembership\/order. Get the ID from\n`GET \/api\/v1\/streams\/{stream}\/queues\/{type}`. The item must already be playable in\nthat queue; foreign, deleted, processing, failed or incompatible media is rejected.\nExternal-video IDs are strings, including legacy IDs; uploaded media IDs are UUIDs.\nPublish any Studio draft changes before requesting an item newly added to the queue.\n\nSupports the same queues, active-stream requirement, asynchronous delivery and\nper-player rate limit as Skip the current queue item. For a continuous channel,\nuse loop playback mode and send this request from your external scheduler at the\nprogram's start time. Delivery and media loading latency still apply.\n\nNative streams require a daemon version with URI playback endpoints. Older\ndaemon processes fail delivery safely until updated on their next normal start."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 202,
                            "body": "{\"data\": {\"stream_id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"queue\": \"video\", \"action\": \"play\", \"item_id\": \"9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\", \"position_seconds\": 90}, \"message\": \"Playback request accepted.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\": \"Playback can only be controlled while the stream is active.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"This item is not available for playback in this queue.\", \"errors\": {\"item_id\": [\"This item is not available for playback in this queue.\"]}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 429,
                            "body": "{\"message\": \"Play requests can only be sent once every 1 second per type.\"}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Get what is playing now",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/now-playing",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/now-playing",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns what the stream's audio and video players are playing right now, in one\nresponse. `audio` and `video` are always present and are `null` when nothing plays\non that player: the stream is not active, the audio source is a radio URL or the\naudio queue is empty, or the stream has no video queue to play.\n\nEach entry carries the item's `id` (a media UUID for library files, or the item id\nfor an external video), which is the same id as `media_id` in play history, its\n`name`, the audio file's `title`, `artist` and `album` (`null` for video and external\nitems, or when the file has no such tag), its `type`, when it started and its\n`duration` in seconds.\n\n`started_at` is when Upstream's player started the track, or resumed it after the\nstream was refreshed or restarted. It does not include encoding or platform delivery\ndelay. With an audio crossfade, it is the moment the new track begins fading in.\n`server_time` is Upstream's clock for this response, so you can work out elapsed time\nas `server_time - started_at` without trusting your own clock.\n\nRequests count toward the account's shared limit of 60 per minute, so poll every 10\nto 15 seconds per stream."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": {\"server_time\": \"2026-11-03T14:05:12+00:00\", \"audio\": {\"id\": \"9d1c2f4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\", \"name\": \"night-drive.mp3\", \"title\": \"Night Drive\", \"artist\": \"Example Artist\", \"album\": null, \"type\": \"audio\", \"started_at\": \"2026-11-03T14:02:41+00:00\", \"duration\": 214.5}, \"video\": null}}",
                            "name": "Audio playing, no video"
                        },
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": {\"server_time\": \"2026-11-03T14:05:12+00:00\", \"audio\": null, \"video\": null}}",
                            "name": "Nothing playing"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        }
                    ]
                },
                {
                    "name": "List a stream's play history",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/play-history",
                            "query": [
                                {
                                    "key": "type",
                                    "value": "audio",
                                    "description": "Only return tracks of this type: `audio` or `video`. Both are returned when omitted.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "15",
                                    "description": "Number of items per page (1 to 100). Defaults to 15.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to return. Defaults to 1.",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/play-history?type=audio&per_page=15&page=1",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the tracks that have played on a stream, newest first, paginated. Each entry\ncarries the item's `media_id`, which matches `id` in now playing, its `name`, its\n`type` (`audio` or `video`), when it started playing and when it stopped. `ended_at`\nis `null` while the item is still playing, and is set when the next track of that\ntype starts or the stream stops. Filter with `type=audio` or `type=video`; both are\nreturned when it is omitted.\n\nPlay history is available on request through support. A stream without it returns\n403 with an explanatory message."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"1f0c6a52-8d3e-4b7a-9f1c-2e5d7a9b3c4d\", \"media_id\": \"9d1c2f4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\", \"name\": \"night-drive.mp3\", \"type\": \"audio\", \"started_at\": \"2026-11-03T14:02:41+00:00\", \"ended_at\": null, \"expected_duration\": 214}, {\"id\": \"7c3e9a10-2b4d-4f6a-8c1e-3d5f7a9b1c2e\", \"media_id\": \"3a5c7e9b-1d2f-4a6c-8e0b-4d6f8a0c2e4b\", \"name\": \"intro.mp3\", \"type\": \"audio\", \"started_at\": \"2026-11-03T13:58:12+00:00\", \"ended_at\": \"2026-11-03T14:02:41+00:00\", \"expected_duration\": 269}], \"links\": {\"first\": \"...\", \"last\": \"...\", \"prev\": null, \"next\": null}, \"meta\": {\"current_page\": 1, \"last_page\": 1, \"per_page\": 15, \"total\": 2, \"from\": 1, \"to\": 2}}",
                            "name": "Play history"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"Play history is not enabled for this stream. Contact support to enable it.\", \"code\": \"feature_not_enabled\", \"next_step\": \"Do not retry. Ask Upstream support to enable play history for this stream.\"}",
                            "name": "Play history not enabled"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The selected type is invalid.\", \"errors\": {\"type\": [\"The selected type is invalid.\"]}}",
                            "name": "Invalid type"
                        }
                    ]
                },
                {
                    "name": "List a stream's ad-break requests",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/ad-breaks",
                            "query": [
                                {
                                    "key": "per_page",
                                    "value": "15",
                                    "description": "Number of entries per page (1 to 100). Defaults to 15.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to return. Defaults to 1.",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/ad-breaks?per_page=15&page=1",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the ad-break requests Upstream received for a stream, newest first,\npaginated. Each entry carries when the ad break was requested, the length asked for\nin seconds, its `outcome` and, unless it was accepted, a `reason`.\n\n`outcome` is one of:\n\n- `accepted`: YouTube accepted the ad-break request. `reason` is `null`.\n- `rejected`: YouTube answered the request with an error. `reason` is `youtube_rejected`.\n- `failed`: Upstream could not get an answer from YouTube, for example a network error or a YouTube server error. `reason` is `youtube_unavailable`.\n- `not_sent`: Upstream did not send the request to YouTube. `reason` says why: `youtube_not_connected` (no YouTube account is connected to the stream), `youtube_reconnect_required` (the YouTube connection needs to be reconnected), `not_live` (the stream is not live on YouTube) or `broadcast_not_streaming` (YouTube recently reported that the broadcast is not receiving video yet, so Upstream waits before asking again).\n\n`accepted` means YouTube accepted the ad-break request. It does not confirm that any viewer saw an ad. Ads YouTube inserts on its own are not visible to Upstream.\n\nAd-break history is available on request through support. A stream without it\nreturns 403 with an explanatory message."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\": [{\"id\": \"4b7e2c9a-1d3f-4e5a-8b6c-7d9e0f1a2b3c\", \"requested_at\": \"2026-11-03T14:30:00+00:00\", \"requested_duration\": 30, \"outcome\": \"accepted\", \"reason\": null}, {\"id\": \"8c1d3e5f-7a9b-4c2d-9e0f-1a2b3c4d5e6f\", \"requested_at\": \"2026-11-03T14:00:00+00:00\", \"requested_duration\": 30, \"outcome\": \"not_sent\", \"reason\": \"not_live\"}], \"links\": {\"first\": \"...\", \"last\": \"...\", \"prev\": null, \"next\": null}, \"meta\": {\"current_page\": 1, \"last_page\": 1, \"per_page\": 15, \"total\": 2, \"from\": 1, \"to\": 2}}",
                            "name": "Ad-break requests"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"Ad-break history is not enabled for this stream. Contact support to enable it.\", \"code\": \"feature_not_enabled\", \"next_step\": \"Do not retry. Ask Upstream support to enable ad-break history for this stream.\"}",
                            "name": "Ad-break history not enabled"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The per page must be an integer.\", \"errors\": {\"per_page\": [\"The per page must be an integer.\"]}}",
                            "name": "Invalid per_page"
                        }
                    ]
                }
            ]
        },
        {
            "name": "WebSocket live updates",
            "description": "",
            "item": [
                {
                    "name": "Authorize a WebSocket subscription",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/realtime\/auth",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/realtime\/auth"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"socket_id\":\"123456.789012\",\"channel_name\":\"private-api.v1.key.123.stream.00000000-0000-4000-8000-000000000001\"}"
                        },
                        "description": "Live now-playing updates are available on request through support, enabled per account or per stream."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"auth\": \"example-app-key:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or expired key"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The socket id field is required.\", \"errors\": {\"socket_id\": [\"The socket id field is required.\"]}}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Get WebSocket connection details",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/realtime",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/realtime",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Call each time your client starts. Treat the channel as an opaque string.\nLive updates are available on request through support, enabled per account or per stream.\nRead-only keys work."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"host\":\"studio.upstream.so\",\"port\":443,\"app_key\":\"example-app-key\",\"channel\":\"private-api.v1.key.123.stream.9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e\",\"event\":\"now-playing.updated\",\"auth_url\":\"https:\/\/studio.upstream.so\/api\/v1\/realtime\/auth\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\":\"Unauthenticated.\"}",
                            "name": "Missing or expired key"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"This action is unauthorized.\"}",
                            "name": "Caller not allowed"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"Live updates are not enabled for this stream. Contact support to enable it.\",\"code\":\"feature_not_enabled\",\"next_step\":\"Do not retry. Ask Upstream support to enable live updates for this stream.\"}",
                            "name": "Live updates not enabled"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\":\"Resource not found.\"}",
                            "name": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Multistreaming",
            "description": "",
            "item": [
                {
                    "name": "List destinations",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/destinations",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/destinations",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the multistream destinations for a stream. Destination stream keys are\nnever exposed."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":[{\"id\":\"a341d578-2419-40d1-a2f9-a34a5fcc6a73\",\"name\":\"aut adipisci\",\"platform\":\"youtube\",\"url\":null,\"status\":\"active\",\"include_in_schedule\":true},{\"id\":\"a341d578-b5c7-4f54-aa23-f51d775a9ab8\",\"name\":\"deleniti nemo\",\"platform\":\"youtube\",\"url\":null,\"status\":\"active\",\"include_in_schedule\":true}]}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        }
                    ]
                },
                {
                    "name": "Add a destination",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/destinations",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/destinations",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"Backup YouTube\",\"platform\":\"youtube\",\"url\":\"AbCdEfGh123\",\"key\":\"abcd-efgh-ijkl-mnop-qrst\",\"include_in_schedule\":true,\"status\":\"active\"}"
                        },
                        "description": "Adds a multistream destination to a stream (max 10 per stream). Returns `201 Created`."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\"data\":{\"id\":\"a341d579-513b-4f67-862d-fc2dcf5a46db\",\"name\":\"architecto eius\",\"platform\":\"youtube\",\"url\":null,\"status\":\"active\",\"include_in_schedule\":true}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Stream not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"This stream already has the maximum of 10 destinations.\"}",
                            "name": "Limit reached"
                        }
                    ]
                },
                {
                    "name": "Update a destination",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/destinations\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/destinations\/:id",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "7c1a9b2e-4ada-bec1-74fd-fdc171b3a21b",
                                    "description": "The destination's UUID."
                                }
                            ]
                        },
                        "method": "PATCH",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"Backup YouTube\",\"platform\":\"youtube\",\"url\":\"AbCdEfGh123\",\"key\":\"abcd-efgh-ijkl-mnop-qrst\",\"include_in_schedule\":true,\"status\":\"active\"}"
                        },
                        "description": "Updates a multistream destination. Send only the fields you want to change."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d579-ebc7-41ad-934b-a38d3e681a8c\",\"name\":\"architecto eius\",\"platform\":\"youtube\",\"url\":null,\"status\":\"active\",\"include_in_schedule\":true}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Destination not found"
                        }
                    ]
                },
                {
                    "name": "Remove a destination",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/streams\/:stream_id\/destinations\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/streams\/:stream_id\/destinations\/:id",
                            "variable": [
                                {
                                    "id": "stream_id",
                                    "key": "stream_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The stream's UUID."
                                },
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "7c1a9b2e-4ada-bec1-74fd-fdc171b3a21b",
                                    "description": "The destination's UUID."
                                }
                            ]
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Deletes a multistream destination. Returns an empty 204 response."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Deleted"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Stream owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Destination not found"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Media",
            "description": "",
            "item": [
                {
                    "name": "Start a media upload",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/media\/uploads",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/media\/uploads"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "[]"
                        },
                        "description": "Returns an upload ticket \u2014 a TUS endpoint plus a short-lived bearer token \u2014 for\nuploading a media file to your library with a resumable (TUS 1.0.0) client.\n\n**Complete, runnable examples** \u2014 Node.js, Python, Go and cURL, each doing the full\nmint \u2192 upload \u2192 poll flow against a ready-to-upload sample clip \u2014 are on GitHub:\n<https:\/\/github.com\/upstream-so\/upstream-upload-examples>\n\nThe flow has three steps:\n1. Call this endpoint to get `upload_url`, `token` and `expires_at`.\n2. Upload the file to `upload_url` with any TUS 1.0.0 client, sending\n   `Authorization: Bearer {token}` and the file name in `Upload-Metadata`. To place\n   the file in a folder you own, send its UUID as a `Folder-Id` header \u2014 the server\n   validates ownership and silently ignores an unknown or foreign id (the file then\n   lands at the library root). When the upload finishes, the response carries the new\n   file's id in the `storage-id` header.\n3. Poll `GET \/api\/v1\/media\/{id}` until `is_processing` is `false`.\n\nOne token family drives many uploads \u2014 sequential or concurrent \u2014 for its full 24-hour\nlife; it is validated per request, not consumed. Minting another ticket renews that\nfamily, so existing tickets and in-flight uploads remain valid. Reuse one ticket for a\nbatch when practical. To invalidate every active ticket immediately, call\n`DELETE \/api\/v1\/media\/uploads`.\n\nExample with tus-js-client:\n\n```js\nimport * as tus from 'tus-js-client'\n\nconst { upload_url, token } = ticket.data \/\/ from POST \/api\/v1\/media\/uploads\nconst upload = new tus.Upload(file, {\n  endpoint: upload_url,\n  headers: { Authorization: `Bearer ${token}`, 'Folder-Id': folderId }, \/\/ Folder-Id optional\n  metadata: { name: file.name },\n  onAfterResponse: (req, res) => {\n    const id = res.getHeader('storage-id')\n    if (id) console.log('media id:', id) \/\/ then poll GET \/api\/v1\/media\/{id}\n  },\n  onError: console.error,\n})\nupload.start()\n```\n\n`upload_url` points at your account's default (closest) region. The token is valid on\nevery regional upload server, so you may instead upload to the nearest:\n- Europe \u2014 `https:\/\/e.upstream.so\/api\/upload\/`\n- America \u2014 `https:\/\/a.upstream.so\/api\/upload\/`\n- Asia \u2014 `https:\/\/i.upstream.so\/api\/upload\/`"
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"upload_url\":\"https:\/\/e.upstream.so\/api\/upload\/\",\"token\":\"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\"expires_at\":\"2026-06-27T12:00:00+00:00\",\"folder_id\":null}}",
                            "name": "Upload ticket"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\":\"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\":\"This action is unauthorized.\"}",
                            "name": "Account has no active subscription or trial"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\":\"The folder_id must be a folder you own.\",\"errors\":{\"folder_id\":[\"The folder_id must be a folder you own.\"]}}",
                            "name": "folder_id is not a folder you own"
                        }
                    ]
                },
                {
                    "name": "Revoke all active upload tickets",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/media\/uploads",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/media\/uploads"
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Immediately invalidates the account's active upload-ticket family. Any in-flight\nAny subsequent request using one of those tickets will receive 401; mint a new ticket to resume."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Upload tickets revoked"
                        }
                    ]
                },
                {
                    "name": "List media files",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/media",
                            "query": [
                                {
                                    "key": "type",
                                    "value": "audio",
                                    "description": "Filter by file type: `video`, `audio`, `image`, or `font`.",
                                    "disabled": false
                                },
                                {
                                    "key": "search",
                                    "value": "intro",
                                    "description": "Case-insensitive match against the file name. Must not be greater than 255 characters.",
                                    "disabled": false
                                },
                                {
                                    "key": "folder_id",
                                    "value": "root",
                                    "description": "A folder UUID to list that folder's files, or `root` for files not in any folder.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to return. Defaults to 1.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "15",
                                    "description": "Number of files per page (1\u2013100). Defaults to 15.",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/media?type=audio&search=intro&folder_id=root&page=1&per_page=15"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the media files owned by the authenticated account, newest first,\npaginated. Filter by `type`, by a `search` term matched against the file name,\nor by `folder_id` (a folder's UUID, or `root` for files not in any folder)."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":[{\"id\":\"a341d57a-573c-4f46-921b-381eb6291684\",\"is_read_only\":false,\"library\":null,\"name\":\"architecto\",\"file_type\":\"audio\",\"extension\":\"skt\",\"size\":629000564,\"duration\":null,\"resolution\":null,\"title\":null,\"artist\":null,\"album\":null,\"year\":null,\"genre\":null,\"folder_id\":null,\"is_processing\":false},{\"id\":\"a341d57a-c19e-445c-9ba4-765335e4704a\",\"is_read_only\":false,\"library\":null,\"name\":\"ab\",\"file_type\":\"video\",\"extension\":\"lasxml\",\"size\":3498,\"duration\":null,\"resolution\":null,\"title\":null,\"artist\":null,\"album\":null,\"year\":null,\"genre\":null,\"folder_id\":null,\"is_processing\":false}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"path\":\"\\\/\",\"per_page\":15,\"to\":2,\"total\":2}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The folder_id must be a valid UUID or \\\"root\\\".\", \"errors\": {\"folder_id\": [\"The folder_id must be a valid UUID or \\\"root\\\".\"]}}",
                            "name": "Invalid filter"
                        }
                    ]
                },
                {
                    "name": "Get a media file",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/media\/:media_id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/media\/:media_id",
                            "variable": [
                                {
                                    "id": "media_id",
                                    "key": "media_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The media file's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns a single media file owned by the authenticated account."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d57b-3d3d-4b66-adce-fd25affcf5e5\",\"is_read_only\":false,\"library\":null,\"name\":\"aut\",\"file_type\":\"audio\",\"extension\":\"wmx\",\"size\":1031881,\"duration\":null,\"resolution\":null,\"title\":null,\"artist\":null,\"album\":null,\"year\":null,\"genre\":null,\"folder_id\":null,\"is_processing\":false}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "File owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "File not found"
                        }
                    ]
                },
                {
                    "name": "Update a media file",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/media\/:media_id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/media\/:media_id",
                            "variable": [
                                {
                                    "id": "media_id",
                                    "key": "media_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The media file's UUID."
                                }
                            ]
                        },
                        "method": "PATCH",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"intro.mp4\",\"title\":\"My Title\",\"artist\":\"My Artist\",\"album\":\"My Album\",\"year\":\"2026\",\"genre\":\"Lofi\"}"
                        },
                        "description": "Updates a media file owned by the authenticated account. Send only the fields you\nwant to change. `name` renames any file; the audio metadata fields (`title`,\n`artist`, `album`, `year`, `genre`) apply to audio files only and are rejected on\nother types."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d57b-b5a5-410a-9368-2134132a9a98\",\"is_read_only\":false,\"library\":null,\"name\":\"architecto\",\"file_type\":\"audio\",\"extension\":\"skt\",\"size\":629000564,\"duration\":null,\"resolution\":null,\"title\":null,\"artist\":null,\"album\":null,\"year\":null,\"genre\":null,\"folder_id\":null,\"is_processing\":false}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "File owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "File not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"Metadata can only be edited for audio files.\", \"errors\": {\"title\": [\"Metadata can only be edited for audio files.\"]}}",
                            "name": "Metadata on a non-audio file"
                        }
                    ]
                },
                {
                    "name": "Delete a media file",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/media\/:media_id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/media\/:media_id",
                            "variable": [
                                {
                                    "id": "media_id",
                                    "key": "media_id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The media file's UUID."
                                }
                            ]
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Deletes a media file owned by the authenticated account. The file is removed from\nevery stream's queues and every saved preset, and deleted from storage. A file a content calendar Block\nplaces on an upcoming airing is refused with 409; remove it from the Block first. Returns an empty 204 response."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Deleted"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "File owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "File not found"
                        },
                        {
                            "header": [],
                            "code": 409,
                            "body": "{\"message\": \"You can't delete files used by Blocks placed on a content calendar: \u201cLofi Night\u201d (Main channel)\"}",
                            "name": "Used by a Block placed on a content calendar"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Folders",
            "description": "",
            "item": [
                {
                    "name": "List folders",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/folders",
                            "query": [
                                {
                                    "key": "parent_id",
                                    "value": "root",
                                    "description": "A folder UUID to list its direct children, or `root` for top-level folders.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to return. Defaults to 1.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "15",
                                    "description": "Number of folders per page (1\u2013100). Defaults to 15.",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/folders?parent_id=root&page=1&per_page=15"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns the folders owned by the authenticated account, newest first, paginated.\nFilter by `parent_id` (a folder's UUID for its direct children, or `root` for\ntop-level folders)."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":[{\"id\":\"a341d57d-bedc-40c4-8680-38af54939870\",\"is_read_only\":false,\"library\":null,\"name\":\"Mr. Mustafa Price PhD\",\"parent_id\":null},{\"id\":\"a341d57e-1af4-4380-b507-a0f545c0c263\",\"is_read_only\":false,\"library\":null,\"name\":\"Prof. Cleve Hahn\",\"parent_id\":null}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"path\":\"\\\/\",\"per_page\":15,\"to\":2,\"total\":2}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The parent_id must be a valid UUID or \\\"root\\\".\", \"errors\": {\"parent_id\": [\"The parent_id must be a valid UUID or \\\"root\\\".\"]}}",
                            "name": "Invalid filter"
                        }
                    ]
                },
                {
                    "name": "Create a folder",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/folders",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/folders"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"Clips\"}"
                        },
                        "description": "Creates a folder owned by the authenticated account. Omit `parent_id` (or send null)\nfor a top-level folder, or pass an owned folder's UUID to nest it. Returns `201 Created`."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\"data\":{\"id\":\"a341d57e-7643-4090-b25a-61b822f1c4a0\",\"is_read_only\":false,\"library\":null,\"name\":\"Ms. Audra Crooks II\",\"parent_id\":null}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Account has no streaming plan"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"Acting as another account is not supported on the API.\"}",
                            "name": "Acting as another account"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The name field is required.\", \"errors\": {\"name\": [\"The name field is required.\"]}}",
                            "name": "Invalid input"
                        }
                    ]
                },
                {
                    "name": "Move files",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/folders\/move-files",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/folders\/move-files"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"media_ids\":[\"6ff8f7f6-1eb3-3525-be4a-3932c805afed\"]}"
                        },
                        "description": "Moves the given media files into a folder, or to the root. Pass `folder_id` (an owned\nfolder's UUID) to move them into that folder, or omit it (or send null) to move them\nto the root. Every file \u2014 and the destination folder \u2014 must be owned by the\nauthenticated account. Returns an empty 204."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Moved"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"Acting as another account is not supported on the API.\"}",
                            "name": "Acting as another account"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"One or more of the media files do not belong to you.\", \"errors\": {\"media_ids\": [\"One or more of the media files do not belong to you.\"]}}",
                            "name": "A file is not owned by the caller"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The selected folder is invalid.\", \"errors\": {\"folder_id\": [\"The selected folder is invalid.\"]}}",
                            "name": "The destination folder is not owned by the caller"
                        }
                    ]
                },
                {
                    "name": "Get a folder",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/folders\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/folders\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The folder's UUID."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns a single folder owned by the authenticated account. List a folder's\nchildren with `GET \/folders?parent_id={id}`."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d57e-d49c-43d6-afeb-39983ace6c16\",\"is_read_only\":false,\"library\":null,\"name\":\"Morgan Hirthe\",\"parent_id\":null}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Folder owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Folder not found"
                        }
                    ]
                },
                {
                    "name": "Update a folder",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/folders\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/folders\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The folder's UUID."
                                }
                            ]
                        },
                        "method": "PATCH",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"Renamed clips\"}"
                        },
                        "description": "Updates a folder owned by the authenticated account. Send `name` to rename, and\/or\n`parent_id` to move it (an owned folder's UUID to nest it, or null to move it to the\nroot). A folder can't be moved into itself or one of its descendants."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d57f-33e4-4563-a08b-f57fc47a266e\",\"is_read_only\":false,\"library\":null,\"name\":\"Ms. Audra Crooks II\",\"parent_id\":null}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Folder owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Folder not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"A folder cannot be moved into itself or its descendants.\", \"errors\": {\"parent_id\": [\"A folder cannot be moved into itself or its descendants.\"]}}",
                            "name": "Cyclic move"
                        }
                    ]
                },
                {
                    "name": "Delete a folder",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/folders\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/folders\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The folder's UUID."
                                }
                            ]
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Deletes a folder owned by the authenticated account. Its subfolders are deleted too,\nand any files inside are moved to the root (not deleted). Returns an empty 204."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Deleted"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Folder owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Folder not found"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Tags",
            "description": "",
            "item": [
                {
                    "name": "List tags",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/tags",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/tags"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns all the tags owned by the authenticated account, ordered by name (not\npaginated \u2014 the full set is small and is meant to populate a tag picker). Tag\nnames can be assigned to streams via the stream create\/update endpoints."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":[{\"id\":\"a341d57c-29e5-428f-9d03-1bb43e9dc3fa\",\"name\":\"aut\",\"color\":\"#a11e59\",\"icon\":\"X\"},{\"id\":\"a341d57c-8a63-4045-b1f4-d33fbd7e86a9\",\"name\":\"enim\",\"color\":\"#a453cd\",\"icon\":\"X\"}]}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        }
                    ]
                },
                {
                    "name": "Create a tag",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/tags",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/tags"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"lofi\",\"color\":\"#3366FF\",\"icon\":\"music\"}"
                        },
                        "description": "Creates a tag owned by the authenticated account. Tag names are unique per account.\nReturns `201 Created`."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\"data\":{\"id\":\"a341d57c-ee11-4996-9e96-62275b1705ab\",\"name\":\"architecto\",\"color\":\"#66e353\",\"icon\":\"X\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The name has already been taken.\", \"errors\": {\"name\": [\"The name has already been taken.\"]}}",
                            "name": "Validation failed"
                        }
                    ]
                },
                {
                    "name": "Update a tag",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/tags\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/tags\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The tag's UUID."
                                }
                            ]
                        },
                        "method": "PATCH",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"lofi\",\"color\":\"#3366FF\",\"icon\":\"music\"}"
                        },
                        "description": "Updates a tag owned by the authenticated account. Send only the fields you want to change."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\"data\":{\"id\":\"a341d57d-54e7-43d7-b26a-b315350d1078\",\"name\":\"architecto\",\"color\":\"#66e353\",\"icon\":\"X\"}}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Tag owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Tag not found"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The name has already been taken.\", \"errors\": {\"name\": [\"The name has already been taken.\"]}}",
                            "name": "Validation failed"
                        }
                    ]
                },
                {
                    "name": "Delete a tag",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/tags\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/tags\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": "9b2e7c1a-4f3d-4a8b-9c2e-1f3d4a8b9c2e",
                                    "description": "The tag's UUID."
                                }
                            ]
                        },
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Deletes a tag owned by the authenticated account and removes it from any streams.\nReturns an empty 204 response."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 204,
                            "body": "",
                            "name": "Deleted"
                        },
                        {
                            "header": [],
                            "code": 401,
                            "body": "{\"message\": \"Unauthenticated.\"}",
                            "name": "Missing or invalid token"
                        },
                        {
                            "header": [],
                            "code": 403,
                            "body": "{\"message\": \"This action is unauthorized.\"}",
                            "name": "Tag owned by another account"
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Resource not found.\"}",
                            "name": "Tag not found"
                        }
                    ]
                }
            ]
        }
    ],
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "Authorization",
                "type": "string"
            }
        ]
    }
}