---
title: "/showcases/:showcaseId"
method: PATCH
path: "/v1/showcases/{showcaseId}"
tags: ["Showcases"]
---

# /showcases/:showcaseId

`PATCH /v1/showcases/{showcaseId}`

## Request

- Base URL: `api.air.inc` (relative, and the document’s source URL is not known)
- URL: `api.air.inc/v1/showcases/{showcaseId}`
- Auth: one of:
  - API key in header `x-api-key` and API key in header `x-air-workspace-id`
  - HTTP bearer and API key in header `x-air-workspace-id`
- TypeScript: <https://skmtc.dev/air/apis/air-api/docs/v1/showcases/:showcaseId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Rename a showcase or change its description.

Only the fields you send change. An empty body changes nothing and returns `204`.

Returns an empty body on success. Use `GET /v1/showcases/{showcaseId}` to read the showcase.

Requires the `showcases.write` OAuth scope.

## Request body

- object
  - `name` string
  - `description` string, nullable: `null` removes the description

## Response `204`

Showcase updated successfully

## Other responses

- `400`: Invalid request body, including an empty or `null` name
- `403`: You do not have permission to edit this showcase
- `404`: Showcase not found

## Changes

- **2026-11-03** `8e6005b272a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/air/apis/air-api/changes/v1/showcases/:showcaseId/patch.md)

---

[API](https://skmtc.dev/air/apis/air-api.md) - [All operations](https://skmtc.dev/air/apis/air-api/llms.txt) - [OpenAPI document](https://skmtc.dev/air/apis/air-api/revisions/8e6005b272a1?raw)