---
title: "Update the metadata of a terminal theme"
method: PATCH
path: "/companies/{companyId}/terminalThemes/{id}"
tags: ["Terminal themes - company level"]
---

# Update the metadata of a terminal theme

`PATCH /companies/{companyId}/terminalThemes/{id}`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/companies/{companyId}/terminalThemes/{id}`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Changes the metadata, consisting of the name and dark or light mode, of the terminal theme specified in the path.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#manage-api-permissions):
- Management API - Terminal themes read and write

## Path parameters

- `companyId` string, required
- `id` string, required

## Request body

- ThemeUpdateRequest: The request body for updating the metadata of a terminal theme.
  - `mode` 'dark' | 'light': The terminal display mode. Possible values: **dark**, **light**.
  - `name` string, nullable: The name of the theme. Must be unique per account within the same company context.

## Response `200`

OK

- UpdateThemeResponse: The response containing the updated terminal theme details.
  - `id` string, required: The unique identifier of the theme.
  - `mode` 'dark' | 'light', required: The terminal display mode. Possible values: **dark**, **light**.
  - `name` string, required: The name of the theme.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-09-23** (v3) `55cb8143ce0e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adyen/apis/management-api/changes/companies/:companyId/terminalThemes/:id/patch.md)

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)