---
title: "Update Placement"
method: PATCH
path: "/v1/advertising/placements/{placement_key}"
tags: ["advertising"]
---

# Update Placement

`PATCH /v1/advertising/placements/{placement_key}`

## Request

- Base URL: `https://api.shortkit.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shortkit.dev/v1/advertising/placements/{placement_key}`
- Auth: none declared

## Path parameters

- `placement_key` string, required

## Headers

- `if-match` string, nullable

## Request body

- PlacementPatch
  - `enabled` boolean, nullable
  - `mode` 'fixed' | 'adaptive', nullable
  - `firstAfter` integer, nullable
  - `every` integer, nullable
  - `minGap` integer, nullable
  - `maxGap` integer, nullable
  - `sources` PlacementSourcePin[], nullable
    - `sourceId` string, uuid, required
    - `sourceRevision` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `915ff7e82b20`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shortkit/apis/shortkit-api/changes/v1/advertising/placements/:placement_key/patch.md)

---

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