# Schedule a pre-recorded live stream
`POST https://octopus.livepush.io/streams/{stream_id}/config/scheduler/events`
Schedules a pre-recorded live stream to start at a specific
date and time using the configured playlist.

This endpoint is used for both one-time scheduled events
and looping (24/7) streams.
- **Tag:** Stream Scheduler
- **Operation ID:** `postStreamsStreamIdConfigSchedulerEvents`
- **Authentication:** Bearer token required
- **Docs:** https://developers.livepush.io/stream-scheduler/schedule-a-pre-recorded-live-stream/

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `stream_id` | string | yes | Unique identifier of the pre-recorded live stream |


### Request body

`application/json` (required)

- `label` (string) **required** — Human-readable label for the scheduled event
- `datetime` (string<date-time>) **required** — Scheduled start time in ISO 8601 (UTC)
- `immediateStart` (boolean) — Whether the stream should start immediately
- `loop` (boolean) — Whether the event respects looping configuration
- `videos` (string[]) — Optional list of video IDs for this event


```json
{
  "label": "string",
  "datetime": "2026-01-31T09:00:00.000Z",
  "immediateStart": false,
  "loop": false,
  "videos": [
    "string"
  ]
}
```


### Example request

```bash
curl -X POST 'https://octopus.livepush.io/streams/<stream_id>/config/scheduler/events' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "label": "string",
    "datetime": "2026-01-31T09:00:00.000Z",
    "immediateStart": false,
    "loop": false,
    "videos": [
      "string"
    ]
  }'
```


### Responses


#### 200 — Stream scheduled successfully


#### 401 — Unauthorized


#### 404 — Stream not found