---
title: "Add a new process"
method: POST
path: "/api/v3/process"
tags: ["v16.7.2"]
---

# Add a new process

`POST /api/v3/process`

Add a new FFmpeg process

## Request body

- ApiProcessConfig
  - `autostart` boolean
  - `id` string
  - `input` ApiProcessConfigIO[], required
    - `address` string, required
    - `cleanup` ApiProcessConfigIOCleanup[]
      - `max_file_age_seconds` integer
      - `max_files` integer
      - `pattern` string, required
      - `purge_on_delete` boolean
    - `id` string
    - `options` string[]
  - `limits` ApiProcessConfigLimits
    - `cpu_usage` number
    - `memory_mbytes` integer
    - `waitfor_seconds` integer
  - `options` string[]
  - `output` ApiProcessConfigIO[], required
    - `address` string, required
    - `cleanup` ApiProcessConfigIOCleanup[]
      - `max_file_age_seconds` integer
      - `max_files` integer
      - `pattern` string, required
      - `purge_on_delete` boolean
    - `id` string
    - `options` string[]
  - `reconnect` boolean
  - `reconnect_delay_seconds` integer
  - `reference` string
  - `stale_timeout_seconds` integer
  - `type` 'ffmpeg' | ''

## Response `200`

OK

- ApiProcessConfig
  - `autostart` boolean
  - `id` string
  - `input` ApiProcessConfigIO[], required
    - `address` string, required
    - `cleanup` ApiProcessConfigIOCleanup[]
      - `max_file_age_seconds` integer
      - `max_files` integer
      - `pattern` string, required
      - `purge_on_delete` boolean
    - `id` string
    - `options` string[]
  - `limits` ApiProcessConfigLimits
    - `cpu_usage` number
    - `memory_mbytes` integer
    - `waitfor_seconds` integer
  - `options` string[]
  - `output` ApiProcessConfigIO[], required
    - `address` string, required
    - `cleanup` ApiProcessConfigIOCleanup[]
      - `max_file_age_seconds` integer
      - `max_files` integer
      - `pattern` string, required
      - `purge_on_delete` boolean
    - `id` string
    - `options` string[]
  - `reconnect` boolean
  - `reconnect_delay_seconds` integer
  - `reference` string
  - `stale_timeout_seconds` integer
  - `type` 'ffmpeg' | ''

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/datarhei/apis/datarhei-core-api.md) · [All operations](https://skmtc.net/datarhei/apis/datarhei-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datarhei/datarhei-core-api/versions/0197dcdcdd5a/schema)