---
title: "Update stream metadata"
method: POST
path: "/streams/{stream}/metadata"
tags: ["Streams"]
---

# Update stream metadata

`POST /streams/{stream}/metadata`

Update the metadata of a stream.

## Path parameters

- `stream` string, required

## Request body

- StreamMetadataItem
  - `eventId` string — Alphanumeric ID.
  - `eventType` string — The type of event.
  - `data` StreamMetadataItemData
    - `maxAge` integer — The maximum age of events in the stream
    - `maxCount` integer — The maximum count of events in the stream
    - `truncateBefore` integer — Events prior to this event are truncated and removed
    - `cacheControl` string — Period of time to make feed head cacheable
    - `acl` object — Access control list for this stream
      - `r` string — Read roles
      - `w` string — Write roles
      - `d` string — Delete roles
      - `mr` string — Metadata read roles
      - `mw` string — Metadata write roles

## Response `201`

New stream created

## Other responses

- `307` — Temporary Redirect
- `400` — Write request body invalid
- `401` — Unauthorized
- `404` — Not found
- `410` — Gone
- `413` — Request entity too large

---

[API](https://skmtc.net/kurrent-io/apis/http-api.md) · [All operations](https://skmtc.net/kurrent-io/apis/http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kurrent-io/http-api/versions/b7fd712e809c/schema)