---
title: "Update Cookie"
method: PUT
path: "/v1/cookies"
tags: ["Cookies"]
---

# Update Cookie

`PUT /v1/cookies`

## Request

- Base URL: `https://customer.my.onetrust.com/api/cookiemanager`
- URL: `https://customer.my.onetrust.com/api/cookiemanager/v1/cookies`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{$$.env.host}/api/access/v1/oauth/token` scopes: `COOKIE`

Use this API to update an existing cookie.
> 🗒 Things to Know
> 
> - There are two types of IDs for cookies: Cookie ID and Domain Cookie ID. The **Cookies Results All Domains** export can be downloaded from the Categorizations screen in the OneTrust application to select the ID for the `cookieId` parameter.
> - For manually created cookies, only `cookieName`, `lifespan`, an `host` will be updated.
> - Values must be passed in all the parameters within `descriptionTranslations` for a cookie translation to be updated.

## Request body

- object
  - `cookieId` string, required: ID of the cookie. This value is obtained from [Create Cookie](/onetrust/reference/createnewcookie) API.
  - `cookieName` string: Name of the cookie.
  - `lifespan` 'PERSISTENT' | 'SESSION': Lifespan of the cookie.
  - `host` string: Host of the cookie.
  - `description` string: Description of the cookie. or less
  - `thirdPartyDescription` string: Short text describing the host’s purpose or description of the cookie. It should be 1075 characters or less.
  - `customCategoryName` string: Unique identifier of a cookie category (Cookie Category ID).
  - `length` integer: Length of the cookie lifespan, enter a number greater than 0 if this is a persistent cookie, otherwise leave as 0.
  - `durationType` 1 | 7 | 30 | 365: Unit of time for the cookie lifespan, enter 1 (for days), 7 (for weeks), 30 (for months), or 365 (for years) based on the time unit the cookie lifespan is measured in.
  - `domainCookieCategoryList` object[]: A list of domain level categorizations for the cookie.
    - `domainId` string: ID of a domain.
    - `customCategoryName` string: Unique identifier of a cookie category (cookie category ID).
    - `thirdParty` boolean: Flag indicating if the cookie is third-party or first-party, use false if the cookie is first-party.
  - `domainToDeleteIds` string[]: A list of domain IDs to be unassigned from cookie.
  - `domainCookieSource` object[]: Domain Cookie Source to be added.
    - `domainId` string: Unique Identifier of a domain.
    - `domainCookieSourceRequestDtoList` object[]
      - `ResourceUrl` string
  - `domainCookieSourceToDelete` object[]: Domain Cookie Source to be removed.
    - `id` string: Unique Identifier of a domain cookie source.
  - `descriptionTranslations` object[]: Description translations
    - `langCode` string: Language code.
    - `defaultDescription` string: Short text describing what is the purpose of the cookie.
    - `thirdPartyDescription` string: Short text describing the host’s purpose or description. of the cookie

## Response `200`

Update completed. Response may include error messages indicating what changes were not complete.

- object
  - `status` string: Status of the API.
  - `errorMessages` string[]

## Other responses

- `400`: Bad Request. **Possible reason**: Invalid cookieid, please check if cookieId passed is correct.
- `401`: Unauthorized.
- `403`: Forbidden. **Possible reasons**: You do not have enough permissions to invoke this endpoint.
- `404`: Not Found.
- `409`
- `429`: Too Many Requests For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).

---

[API](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent-swagger.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent-swagger/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent-swagger/revisions/91142c74595f?raw)