---
title: "Start a record"
method: POST
path: "/1/videos/{channel}/options/recording/instant"
tags: ["Option > Record > Instant"]
---

# Start a record

`POST /1/videos/{channel}/options/recording/instant`

Try to instantly start a recording of the first stream meant to be recorded,
on the first given storage machine.

NOTE: this process is oversimplified.
It assumes that only the best quality stream is meant to be recorded
and that it will be sent to the first given storage machine only.

## Path parameters

- `channel` integer, required

## Query parameters

- `account_id` integer, required — Account identifier

## Request body

- object
  - `auto_stop` boolean, required — The auto_stop field is required
  - `diffusion_at` integer, nullable — The diffusion at time start
  - `diffusion_ends_at` integer, nullable — The diffusion end time is required when auto_stop is enabled
  - `file_path` string, nullable — a strict string (no HTML/PHP tags or HTML entities allowed)
  - `fragment_duration` integer, required — The fragment duration is required and must be at least 1 second.
  - `fragment_number` integer, nullable
  - `name` string, required — The record name is required
  - `selected_storage_id` integer, required — The storage machine id is required.
  - `storage` object[], required — a simple array (weak validation)
    - `storage_machine_id` integer, required — The storage machine id is required.

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` A57c9d69Record
    - `record_id` integer, required
    - `stream_id` string, required — Unique identifier of the `stream` that is related to the resource `Record`
    - `deleted_at` integer, required — Timestamp `Record` has been deleted
    - `diffused_at` integer, required
    - `diffusion_ends_at` integer, required
    - `diffusion_ended_at` integer, required
    - `name` string, required — Name of the resource `Record`
    - `file_path` string, required
    - `state` integer, required
    - `fragment_duration` integer, required
    - `fragment_number` integer, required
    - `end` string, required
    - `auto` string, required
    - `instant` string, required
    - `record_type` string, required
    - `storage_machine` string

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/1c59d729611a/schema)