# Partially update a Listening Theme.

Endpoint: PATCH /listening/theme
Version: 3.0.0
Security: bearerAuth, apiKeyAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer Token

  - `apiKeyAuth` (unknown)
    apiKey in header Key

## Query parameters:

  - `id` (string)
    Listening theme id

## Request fields (application/json):

  - `name` (string)
    Listening Theme name

  - `displayName` (string)
    Listening Theme display name

  - `iconUrl` (string)
    Listening Theme icon url

  - `imageUrl` (string)
    Listening Theme image url

  - `color` (string)
    Listening Theme identification color

  - `filters` (array)
    Filter list

  - `filters.displayName` (string)

  - `filters.isCompoundFilter` (boolean)

  - `filters.negativeFilter` (boolean)

  - `filters.filterType` (string)
    Enum: "FILTER", "LIMIT", "SEARCH", "MATCH_PHRASE_PREFIX", "ADHOC_SEARCH", "EXPRESSION", "GEO_DISTANCE", "ADVANCED_QUERY", "MATCH_NONE", "MATCH_ALL"

  - `filters.field` (string)

  - `filters.values` (array)

  - `filters.accessibleValues` (array)

  - `filters.userFilter` (boolean)

  - `filters.allValuesAllowed` (boolean)

  - `filters.lockedWithValues` (boolean)

  - `filters.hidden` (boolean)

  - `filters.favourite` (boolean)

  - `filters.mandatory` (boolean)

  - `filters.locked` (boolean)

  - `filters.ignoreAddingToDimensionFilter` (boolean)

  - `filters.disabled` (boolean)

  - `filters.details` (object)

  - `filters.filters` (array)

  - `filters.advancedFilters` (array)

  - `filters.advancedFilters.filter` (string)

  - `filters.advancedFilters.fieldInfo` (object)

  - `filters.advancedFilters.valueInfo` (object)

  - `filters.advancedFilters.type` (string)
    Enum: "POST", "COMMENT"

  - `filters.advancedFilters.field` (string)

  - `filters.advancedFilters.details` (object)

  - `filters.advancedFilters.label` (string)

  - `filters.advancedFilters.value` (string)

  - `filters.advancedFilters.additional` (object)

  - `description` (string)
    Description

  - `tags` (array)
    Tags

  - `shareConfig` (object)
    Share configuration

  - `shareConfig.userIds` (array)
    List of User IDs, which is unique identifier for each User

  - `shareConfig.userGroupIds` (array)
    List of User Group IDs, which is unique identifier for each User Group

  - `shareConfig.clientIds` (array)
    List of Client IDs, which is unique identifier for Client

  - `shareConfig.clientGroupIds` (array)
    List of Client Group IDs, which is unique identifier for Client Group

  - `shareConfig.shareWithEveryOne` (boolean)
    Set this true, in order to share with every User

  - `permissionEntity` (object)
    Permission configuration

  - `permissionEntity.userIds` (array)
    List of User IDs, which is unique identifier for each User

  - `permissionEntity.userGroupIds` (array)
    List of User Group IDs, which is unique identifier for each User Group

  - `permissionEntity.clientIds` (array)
    List of Client IDs, which is unique identifier for Client

  - `permissionEntity.clientGroupIds` (array)
    List of Client Group IDs, which is unique identifier for Client Group

  - `permissionEntity.shareWithEveryOne` (boolean)
    Set this true, in order to share with every User

## Response 200:

  - `200` (unknown)
    Success

## Response 400:

  - `400` (unknown)
    Bad request

## Response 400 fields (application/json):

  - `data` (object)

  - `errors` (array)

  - `errors.id` (string, required)
    24-character hex ObjectId

  - `errors.code` (integer, required)

  - `errors.message` (string, required)
    Dotted error key (e.g. account.not.found)

  - `metadata` (object)

## Response 401:

  - `401` (unknown)
    Missing or invalid authentication

## Response 401 fields (application/json):

  - `data` (object)

  - `errors` (array)

  - `errors.id` (string, required)
    24-character hex ObjectId

  - `errors.code` (integer, required)

  - `errors.message` (string, required)
    Dotted error key (e.g. account.not.found)

  - `metadata` (object)

## Response 403:

  - `403` (unknown)
    Insufficient permissions

## Response 403 fields (application/json):

  - `data` (object)

  - `errors` (array)

  - `errors.id` (string, required)
    24-character hex ObjectId

  - `errors.code` (integer, required)

  - `errors.message` (string, required)
    Dotted error key (e.g. account.not.found)

  - `metadata` (object)

## Response 404:

  - `404` (unknown)
    Resource not found

## Response 404 fields (application/json):

  - `data` (object)

  - `errors` (array)

  - `errors.id` (string, required)
    24-character hex ObjectId

  - `errors.code` (integer, required)

  - `errors.message` (string, required)
    Dotted error key (e.g. account.not.found)

  - `metadata` (object)