---
title: "Patch Campaign Settings"
method: PATCH
path: "/v1/campaigns/{campaign_id}/settings"
tags: ["campaigns", "developer-api", "product-api"]
---

# Patch Campaign Settings

`PATCH /v1/campaigns/{campaign_id}/settings`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/campaigns/{campaign_id}/settings`
- Auth: HTTP bearer

## Path parameters

- `campaign_id` string, required

## Headers

- `x-api-key` string, nullable

## Request body

- CampaignSettingsUpdate
  - `title` string, nullable
  - `description` string, nullable
  - `image` string, nullable
  - `language` string, nullable
  - `system` string, nullable
  - `ai_image_gen` boolean, nullable
  - `discord_recap_card_enabled` boolean, nullable
  - `campaign_tone` string, nullable
  - `chat_tone` string, nullable
  - `entities_tone` string, nullable
  - `image_gen_tone` string, nullable
  - `public` boolean, nullable
  - `archived` boolean, nullable

## Response `200`

Successful Response

- CampaignSettingsRead
  - `id` string, required
  - `title` string, required
  - `description` string, nullable
  - `image` string, nullable
  - `language` string
  - `system` string
  - `ai_image_gen` boolean
  - `discord_recap_card_enabled` boolean
  - `campaign_tone` string, nullable
  - `chat_tone` string, nullable
  - `entities_tone` string, nullable
  - `image_gen_tone` string, nullable
  - `public` boolean
  - `archived` boolean
  - `archived_at` string, date-time, nullable
  - `owner_id` string, required
  - `owner_name` string, nullable
  - `admin_ids` string[]
  - `can_archive` boolean
  - `can_delete` boolean
  - `permissions` CampaignPermissionsRead, required
    - `is_owner` boolean
    - `is_world_admin` boolean
    - `can_manage_world` boolean
    - `can_view_quest_log` boolean
    - `can_manage_quest_log` boolean
    - `can_access_player_awards_and_collections` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/myarchivist/apis/archivist-public-api.md) · [All operations](https://skmtc.dev/myarchivist/apis/archivist-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myarchivist/apis/archivist-public-api/revisions/3ea6ca7efc56?raw)