---
title: "Create or Update Flow Average Bit Rate"
method: PUT
path: "/flows/{flowId}/avg_bit_rate"
tags: ["Flows"]
---

# Create or Update Flow Average Bit Rate

`PUT /flows/{flowId}/avg_bit_rate`

Create or update the average bit rate property.

The average bit rate of the Flow Segments in 1000 bits/second.
A precise definition can be found in the [Setting Flow Bit Rate Properties](https://github.com/bbc/tams/blob/main/docs/appnotes/0013-setting-flow-bit-rate-properties.md) AppNote.

When a Flow is created from a Profile then the average bit rate is inherited from the Profile.
In this scenario is it not possible to update the average bit rate directly as it would invalidate the link to the Profile.
Any attempt to update the average bitrate should be rejected by the store with a 400 error message as this is a bad request.
To update the average bit rate then it is necessary to remove the link to the Profile first before updating directly.

## Request body

- integer

## Response `204`

No content. The average bit rate has been created or updated.

## Other responses

- `400` — Bad request. Invalid Flow avg bit rate.
- `403` — Forbidden. You do not have permission to modify this Flow. It may be marked read-only.
- `404` — The requested Flow does not exist.

---

[API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) · [All operations](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/time-addressable-media-store/revisions/eb3977b33601/schema)