---
title: "Rename, pin, or unpin a dispatch setup"
method: PATCH
path: "/api/v1/me/dispatch-setups/{setupId}"
tags: ["Dispatches"]
---

# Rename, pin, or unpin a dispatch setup

`PATCH /api/v1/me/dispatch-setups/{setupId}`

## Path parameters

- `setupId` string, required

## Query parameters

- `jurisdiction` string

## Request body

- object
  - `name` string — New display name (max 120 chars); null clears it.
  - `isPinned` boolean

## Response `200`

Updated dispatch setup

- object
  - `id` string, required
  - `jurisdiction` string
  - `name` string, nullable, required
  - `isPinned` boolean, required
  - `config` object, required
  - `lastDispatchedAt` string, nullable, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `recentDispatches` object[], nullable, required
    - `id` string, required
    - `setupId` string, required
    - `jurisdiction` string
    - `status` string, required
    - `title` string, nullable, required
    - `coveredRepos` string[], nullable, required
    - `coveredRepoUlids` string[], nullable, required
    - `coveredRepoGithubIds` number[], nullable, required
    - `windowSince` string, nullable, required
    - `windowUntil` string, nullable, required
    - `voice` string, nullable, required
    - `voiceBucket` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `completedAt` string, nullable, required

## Other responses

- `400` — Invalid patch body
- `404` — Setup not found
- `503` — entire-api is not configured

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/entire/entire-api/revisions/c3d737ae064e/schema)