---
title: "Update a channel"
method: PATCH
path: "/channels/{id}"
tags: ["Channels"]
---

# Update a channel

`PATCH /channels/{id}`

## Request

- Base URL: `https://api.fanheroapi.com`
- URL: `https://api.fanheroapi.com/channels/{id}`
- Auth: API key in header `apiKey`

## Path parameters

- `id` string, required

## Headers

- `organization` string, required

## Request body

- UpdateChannelInput
  - `name` string: Channel name
  - `description` string: Channel description
  - `kind` 'PUBLIC' | 'EXCLUSIVE' | 'PAYWALL' | 'PRIVATE' | 'GEOLOCKED' | 'AUTO': The access level of the channel (enum).
  - `status` 'PUBLISHED' | 'UNPUBLISHED': Channel status
  - `geofence` GeofenceObject
    - `countryCodes` string[]
    - `type` 'WHITELIST' | 'BLACKLIST'
  - `customization` CustomizationObject
    - `logo` object: Logo image
      - `light` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
      - `dark` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
    - `icon` object: Icon image
      - `light` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
      - `dark` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
    - `thumbnail` ImageDetails
      - `imgPath` string, required: The path to the image.
      - `baseUrl` string, required: The base URL for the image.
  - `entitlements` string[]: Array of product IDs
  - `menu` string: Menu ID
  - `password` string: Password
  - `thumbnail` string: Path to the thumbnail image file in cloud storage

## Response `200`

Channel updated.

- ChannelRestOutput
  - `id` string: Channel ID
  - `name` string: Channel name
  - `slug` string: Channel slug
  - `organization` string: Organization ID
  - `description` string: Channel description
  - `status` string: Channel status
  - `geofence` GeofenceObject
    - `countryCodes` string[]
    - `type` 'WHITELIST' | 'BLACKLIST'
  - `customization` CustomizationObject
    - `logo` object: Logo image
      - `light` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
      - `dark` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
    - `icon` object: Icon image
      - `light` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
      - `dark` ImageDetails, required
        - `imgPath` string, required: The path to the image.
        - `baseUrl` string, required: The base URL for the image.
    - `thumbnail` ImageDetails
      - `imgPath` string, required: The path to the image.
      - `baseUrl` string, required: The base URL for the image.
  - `entitlements` string[]: Array of product IDs
  - `geofenceEntitlements` unknown[]: Geofence entitlements
    - unknown
  - `kind` string: The access level of the channel
  - `access` string: States if the channel is universally available or geolocked.

---

[API](https://skmtc.dev/fanhero/apis/headless-cms-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/revisions/fb8d50c05ee6?raw)