---
title: "Update Folder"
method: PATCH
path: "/studio/v1/folders/{folderId}"
tags: ["Audiences"]
---

# Update Folder

`PATCH /studio/v1/folders/{folderId}`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/studio/v1/folders/{folderId}`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:audience:manage`

Updates one or more attributes of an existing folder without requiring a full replacement.
Supported fields: `name`, `starred`, `description`, and `notes`. Only fields present in the request body are modified; all other attributes remain unchanged.
Use this endpoint to rename a folder, star or unstar it, or update its description and notes.
Returns `200` with the updated folder resource.
Returns `404` if no folder matches the provided `folderId`.

## Path parameters

- `folderId` string, uuid, required

## Request body

- UpdateFolderJsonApiModel: JSON API model for Folder.
  - `data` UpdateFolder: Folder request resource.
    - `type` string: The type of the resource
    - `attributes` UpdateFolderAttributes: Attributes for a folder that organizes audiences in GTM Studio.
      - `name` string: Display name of the folder. Required on create.
      - `description` string: Optional free-text description of the folder's purpose.
      - `notes` string: Optional notes about the folder for internal reference.
      - `starred` boolean: Whether the folder is starred for quick access. Optional; defaults to `false`.

## Response `200`

Success

- FolderJsonApiModel: JSON API model for Folder.
  - `data` Folder, required: Folder request resource.
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` FolderAttributes, required: Attributes for a folder that organizes audiences in GTM Studio.
      - `name` string, required: Display name of the folder. Required on create.
      - `description` string: Optional free-text description of the folder's purpose.
      - `notes` string: Optional notes about the folder for internal reference.
      - `starred` boolean: Whether the folder is starred for quick access. Optional; defaults to `false`.
      - `audiences` string[]: List of `audienceId` values for the audiences contained in this folder. Read-only; updated automatically as audiences are added or moved.
    - `meta` FolderMeta: Metadata for Folder model.
      - `createdAt` string, date-time, required: The timestamp when the resource was created
      - `createdById` integer, required: Id of the user who created the resource
      - `createdByName` string, required: Name of the user who created the resource
      - `updatedAt` string, date-time, required: The timestamp when the resource was last updated
      - `updatedById` integer, required: Id of the user who last updated the resource
      - `updatedByName` string, required: Name of the user who last updated the resource

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/revisions/93a0bebaaac8?raw)