---
title: "Set Flow Read-Only"
method: PUT
path: "/flows/{flowId}/read_only"
tags: ["Flows"]
---

# Set Flow Read-Only

`PUT /flows/{flowId}/read_only`

Set the read-only property. If set to 'true', service implementations SHOULD reject client requests to update Flow metadata (other than the read_only property), and Flow Segments. Service implementations should also reject requests to the [`/flows/{flowId}/storage`](#/operations/POST_flows-flowId-storage) endpoint for the Flow, and requests to delete the Flow.

## Request body

- boolean

## Response `204`

No content. The read_only property has been set to the given value.

## Other responses

- `400` — Bad request. Invalid Flow read_only value. Value must be boolean.
- `403` — Forbidden. You do not have permission to modify this Flow.
- `404` — The requested Flow does not exist.

## Changes

- **2025-10-06** `0eeba8c316ce` — 1 info
  - added the non-success response with the status `403`
- **2025-04-24** `b01aaf8cffe2` — 1 info
  - removed the non-success response with the status `403`

[Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/flows/:flowId/read_only/put.md)

---

[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)