---
title: "Create or update recorder"
method: PUT
path: "/recorder/{id}"
tags: ["recorder"]
---

# Create or update recorder

`PUT /recorder/{id}`

## Path parameters

- `id` integer, required

## Request body

- RecorderSpec — Configuration of a recorder
  - `id` integer, required — Unique identification
  - `capture-length` integer — Maximum packet length or zero for full packet length
  - `filters` RecorderFilter[], required — List of wildcard filters for given recorder
    - `src-prefix` string — Layer 3 source CIDR
    - `src-port` string — Layer 4 source port, zero (or in future range)
    - `dst-prefix` string — Layer 3 destination CIDR
    - `dst-port` string — Layer 4 destination port, zero (or in future range)
    - `protocol` 'TCP' | 'UDP' | 'SCTP' | 'ANY' — Layer 4 protocol

## Response `200`

Updated

## Other responses

- `201` — Created
- `403` — Forbidden
- `500` — Error while creating recorder

## Changes

- **2024-09-03** (v1) `5b32623f4b87` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cilium/apis/cilium-api/changes/recorder/:id/put.md)

---

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