---
title: "Update a player"
method: PATCH
path: "/players/{playerId}"
tags: ["Player Themes"]
---

# Update a player

`PATCH /players/{playerId}`

Use a player ID to update specific details for a player. 
NOTE: It may take up to 10 min before the new player configuration is available from our CDN.

## Path parameters

- `playerId` string, required

## Request body

- PlayerThemeUpdatePayload
  - `name` string — Add a name for your player theme here.
  - `text` string — RGBA color for timer text. Default: rgba(255, 255, 255, 1)
  - `link` string — RGBA color for all controls. Default: rgba(255, 255, 255, 1)
  - `linkHover` string — RGBA color for all controls when hovered. Default: rgba(255, 255, 255, 1)
  - `linkActive` string — RGBA color for the play button when hovered.
  - `trackPlayed` string — RGBA color playback bar: played content. Default: rgba(88, 131, 255, .95)
  - `trackUnplayed` string — RGBA color playback bar: downloaded but unplayed (buffered) content. Default: rgba(255, 255, 255, .35)
  - `trackBackground` string — RGBA color playback bar: background. Default: rgba(255, 255, 255, .2)
  - `backgroundTop` string — RGBA color: top 50% of background. Default: rgba(0, 0, 0, .7)
  - `backgroundBottom` string — RGBA color: bottom 50% of background. Default: rgba(0, 0, 0, .7)
  - `backgroundText` string — RGBA color for title text. Default: rgba(255, 255, 255, 1)
  - `enableApi` boolean — enable/disable player SDK access. Default: true
  - `enableControls` boolean — enable/disable player controls. Default: true
  - `forceAutoplay` boolean — enable/disable player autoplay. Default: false
  - `hideTitle` boolean — enable/disable title. Default: false
  - `forceLoop` boolean — enable/disable looping. Default: false

## Response `200`

Success

- PlayerTheme
  - `name` string — The name of the player theme
  - `text` string — RGBA color for timer text. Default: rgba(255, 255, 255, 1)
  - `link` string — RGBA color for all controls. Default: rgba(255, 255, 255, 1)
  - `linkHover` string — RGBA color for all controls when hovered. Default: rgba(255, 255, 255, 1)
  - `linkActive` string — RGBA color for the play button when hovered.
  - `trackPlayed` string — RGBA color playback bar: played content. Default: rgba(88, 131, 255, .95)
  - `trackUnplayed` string — RGBA color playback bar: downloaded but unplayed (buffered) content. Default: rgba(255, 255, 255, .35)
  - `trackBackground` string — RGBA color playback bar: background. Default: rgba(255, 255, 255, .2)
  - `backgroundTop` string — RGBA color: top 50% of background. Default: rgba(0, 0, 0, .7)
  - `backgroundBottom` string — RGBA color: bottom 50% of background. Default: rgba(0, 0, 0, .7)
  - `backgroundText` string — RGBA color for title text. Default: rgba(255, 255, 255, 1)
  - `enableApi` boolean — enable/disable player SDK access. Default: true
  - `enableControls` boolean — enable/disable player controls. Default: true
  - `forceAutoplay` boolean — enable/disable player autoplay. Default: false
  - `hideTitle` boolean — enable/disable title. Default: false
  - `forceLoop` boolean — enable/disable looping. Default: false
  - `playerId` string, required
  - `createdAt` string, date-time — When the player was created, presented in ATOM UTC format.
  - `updatedAt` string, date-time — When the player was last updated, presented in ATOM UTC format.
  - `assets` PlayerThemeAssets
    - `logo` string — The name of the file containing the logo you want to use.
    - `link` string — The path to the file containing your logo.

## Other responses

- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/apivideo/apis/api-video.md) · [All operations](https://skmtc.net/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/45ec26f342b6/schema)
