---
search:
  tags:
    - Config
    - PATCH
seo:
  description: >-
    Any admin key may change the event's shell settings. Game settings…
    Reference for the PATCH /api/admin/config endpoint in the Athena
    Attack/Defence Admin API.
sidebar:
  label: Apply an idempotent event settings operation
  badge: PATCH
title: Apply an idempotent event settings operation
type: openapi-operation
---
Any admin key may change the event's shell settings. Game settings (tick, flag validity, checker timeout, scoring weights, roster deadline) and the schedule are accepted only from the organizer panel's key, which keeps the event and the Athena account in step; an organizer key is refused with 403 for those fields.

`PATCH /api/admin/config`

**Request body** (`application/json`, required)

- `operationId` (string, required)
- `expectedVersion` (integer, required)
- `settings` (object, required)

Request body example:

```json
{
  "operationId": "string",
  "expectedVersion": 1,
  "settings": {
    "ctfTheme": "string",
    "ctfName": "string",
    "ctfDescription": "string",
    "heroTitle": "string",
    "startDate": "2019-08-24T14:15:22Z",
    "freezeDate": "2019-08-24T14:15:22Z",
    "endDate": "2019-08-24T14:15:22Z",
    "ctfLogoUrl": "string",
    "registrationOpen": true,
    "maxTeamSize": 1,
    "reportNotificationEmails": [
      "user@example.com"
    ],
    "exportIncludeEmails": false,
    "marketing": {
      "hostedBy": "string",
      "prizePool": "string",
      "categories": [],
      "discordUrl": "string",
      "writeupsUrl": "string",
      "contactUrl": "string"
    },
    "rules": "",
    "faq": [],
    "rosterDeadline": "2019-08-24T14:15:22Z",
    "tickSeconds": 60,
    "flagValidityTicks": 1,
    "checkerTimeoutSeconds": 1,
    "scoringWeights": {
      "slaUp": 3,
      "slaRecovering": 1.5,
      "defenceBase": 2,
      "defenceWeight": 1,
      "attackBase": 1,
      "attackWeight": 1,
      "rankWeight": 1,
      "rankReduction": false,
      "reductionMin": 0,
      "reductionMax": 0.8
    }
  }
}
```

**Responses**

- `200` — Success
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `422` — Validation failed
- `500` — Unhandled server error

Response example, 200:

```json
{
  "updated": true,
  "version": 0,
  "changedKeys": [
    "string"
  ],
  "operationId": "string",
  "synchronized": true
}
```
