> ## Documentation Index
> Fetch the complete documentation index at: https://lingopal.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Scheduled Stream

> Update a scheduled stream. Only pending streams can be updated.

## Description

Update a scheduled stream. Only streams in a pending state can be updated. Uses the same request schema as schedule creation.

## Authentication

This endpoint requires an API Key.\
Include your API key in the `x-api-key` header:

```http theme={null}
x-api-key: YOUR_API_KEY
```

## Request

* **Method:** PUT
* **Endpoint:** `/v1/scheduled_streams/{schedule_id}`
* **Path Parameter:**
  * `schedule_id` (string, required): ID of the scheduled stream
* **Body:**

```json theme={null}
{
  "ingest_url": "string",
  "vocals_track": "0",
  "background_track": 0,
  "mix": "-9,-6",
  "enable_captions_708": false,
  "enable_captions_608": false,
  "dst_language": ["en"],
  "src_language": "en",
  "start_wowza": false,
  "use_contextual_translation": false,
  "lipsync": true,
  "channel_uuid": "string",
  "is_hls_stream": false,
  "scheduled_time": "2025-12-07T02:00:00Z",
  "stop_time": "2025-12-07T03:00:00Z",
  "timezone": "America/New_York"
}
```

## Response

* **Status:** 200 OK
* **Content-Type:** `application/json`

```json theme={null}
"string"
```

## Example Usage (cURL)

```bash theme={null}
curl -X PUT "https://streaming.lingopal-dev.com/v1/scheduled_streams/your-schedule-id" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "ingest_url": "rtmp://example.com/live",
    "vocals_track": "0",
    "background_track": 0,
    "mix": "-9,-6",
    "enable_captions_708": false,
    "enable_captions_608": false,
    "dst_language": ["en"],
    "src_language": "en",
    "start_wowza": false,
    "use_contextual_translation": false,
    "lipsync": true,
    "channel_uuid": "your-channel-uuid",
    "is_hls_stream": false,
    "scheduled_time": "2025-12-07T02:00:00Z",
    "timezone": "America/New_York"
  }'
```


## OpenAPI

````yaml PUT /v1/scheduled_streams/{schedule_id}
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  x-ignore-stats:
    get:
      summary: Get Translation Statistics
      description: Get translation statistics for a stream.
      security:
        - ApiKeyAuth: []
      parameters:
        - name: stream_id
          in: path
          description: Stream ID
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  total_translations:
                    type: integer
                  edited_translations:
                    type: integer
                  unique_languages:
                    type: array
                    items:
                      type: string
                  edit_percentage:
                    type: number
                  language_stats:
                    type: object
                    additionalProperties: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        loc:
                          type: array
                          items:
                            type: string
                        msg:
                          type: string
                        type:
                          type: string
  x-translations-temp:
    get:
      summary: Get Translations
      description: Get paginated translations for a stream.
      security:
        - ApiKeyAuth: []
      parameters:
        - name: stream_id
          in: path
          description: Stream ID
          required: true
          schema:
            type: string
        - name: page
          in: query
          description: Page number
          required: false
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          description: Items per page
          required: false
          schema:
            type: integer
            default: 50
        - name: order
          in: query
          description: 'Sort order: ''asc'' for oldest first, ''desc'' for latest first'
          required: false
          schema:
            type: string
            default: desc
        - name: language_id
          in: query
          description: Filter by language ID
          required: false
          schema:
            type: string
        - name: edited
          in: query
          description: Filter by edit status
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  translations:
                    type: array
                    items:
                      type: object
                      properties:
                        stream_id:
                          type: string
                        language_id:
                          type: string
                        segment_id:
                          type: integer
                        timestamp:
                          type: string
                        end_time:
                          type: string
                        original_content:
                          type: string
                        speaker:
                          type: string
                        id:
                          type: integer
                        content:
                          type: string
                        edited:
                          type: boolean
                        created_at:
                          type: string
                        updated_at:
                          type: string
                  total:
                    type: integer
                  page:
                    type: integer
                  per_page:
                    type: integer
                  has_next:
                    type: boolean
                  has_prev:
                    type: boolean
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        loc:
                          type: array
                          items:
                            type: string
                        msg:
                          type: string
                        type:
                          type: string
  version: 1.0.0
servers:
  - url: https://streaming.lingopal.ai
  - url: https://streaming.lingopal-dev.com
security:
  - ApiKeyAuth: []
paths:
  /v1/scheduled_streams/{schedule_id}:
    put:
      summary: Update Scheduled Stream
      description: Update a scheduled stream. Only pending streams can be updated.
      parameters:
        - name: schedule_id
          in: path
          description: schedule_id
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ingest_url:
                  type: string
                vocals_track:
                  type: string
                  default: '0'
                background_track:
                  type: integer
                  default: 0
                mix:
                  type: string
                  default: '-9,-6'
                enable_captions_708:
                  type: boolean
                  default: false
                enable_captions_608:
                  type: boolean
                  default: false
                dst_language:
                  type: array
                  items:
                    type: string
                  default:
                    - en
                src_language:
                  type: string
                  default: en
                start_wowza:
                  type: boolean
                  default: false
                use_contextual_translation:
                  type: boolean
                  default: false
                lipsync:
                  type: boolean
                  default: true
                channel_uuid:
                  type: string
                is_hls_stream:
                  type: boolean
                  default: false
                scheduled_time:
                  type: string
                  format: date-time
                  description: >-
                    Scheduled start time in ISO 8601 format (e.g.,
                    2025-12-07T02:00:00Z)
                stop_time:
                  type: string
                  format: date-time
                  description: Optional scheduled stop time in ISO 8601 format
                timezone:
                  type: string
                  default: ''
              required:
                - ingest_url
                - dst_language
                - src_language
                - scheduled_time
                - timezone
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: string
        '422':
          description: Validation Error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````