---
title: "POST /PutMetadata"
method: POST
path: "/PutMetadata"
---

# POST /PutMetadata

`POST /PutMetadata`

Inserts metadata into the active stream of the specified channel. At most 5 requests per second per channel are allowed, each with a maximum 1 KB payload. (If 5 TPS is not sufficient for your needs, we recommend batching your data into a single PutMetadata call.) At most 155 requests per second per account are allowed. Also see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/metadata.html">Embedding Metadata within a Video Stream</a> in the <i>Amazon IVS User Guide</i>.

## Request body

- object
  - `channelArn` string, required — ARN of the channel into which metadata is inserted. This channel must have an active stream.
  - `metadata` string, password, required — Metadata to insert into the stream. Maximum: 1 KB per request.

## Response `200`

Success

## Other responses

- `480` — ResourceNotFoundException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — ChannelNotBroadcasting
- `484` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/ivs.md) · [All operations](https://skmtc.net/aws/apis/ivs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ivs/versions/32a77504a115/schema)