---
title: "Update a media asset's alt text"
method: PATCH
path: "/api/v1/media/{asset_id}"
tags: ["media"]
---

# Update a media asset's alt text

`PATCH /api/v1/media/{asset_id}`

## Request

- Base URL: `https://api.cadencz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cadencz.com/api/v1/media/{asset_id}`
- Auth: HTTP bearer

## Path parameters

- `asset_id` string, required

## Request body

- AltTextUpdate: Alt text is the only field worth editing after upload — everything else (kind, dimensions, bytes) is a property of the file itself.
  - `alt_text` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `401`: Missing or invalid Supabase bearer token.
- `404`: The requested resource was not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/cadencz/apis/cadencz-api.md) · [All operations](https://skmtc.dev/cadencz/apis/cadencz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencz/apis/cadencz-api/revisions/3392fe5e93db?raw)