---
title: "Replace an existing process"
method: PUT
path: "/api/v3/process/{id}"
tags: ["v16.7.2"]
---

# Replace an existing process

`PUT /api/v3/process/{id}`

Replace an existing process.

## Path parameters

- `id` string, required

## 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
- `404` — Not Found

## Changes

- **2022-10-13** `37e2216cc6a2` — 1 info
  - api tag `v16.7.2` added
- **2022-07-29** `44bcbc1544e1` — 1 info
  - api operation id `restream-3-update` removed and replaced with `process-3-update`
- **2022-05-13** `d0614126abfa` — 2 info
  - api operation id `process-3-update` removed and replaced with `restream-3-update`
  - api tag `v16.7.2` removed

[Change history](https://skmtc.dev/datarhei/apis/datarhei-core-api/changes/api/v3/process/:id/put.md)

---

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