# Update folder

Update a folder by ID.

Endpoint: PATCH /entities/folders/{id}
Version: 1.0.0

## Path parameters:

  - `id` (integer, required)
    Folder to update

## Request fields (application/vnd.treasuredata.v1+json):

  - `id` (string)

  - `type` (string)
    Enum: "folder-segment"

  - `attributes` (object)

  - `attributes.name` (string)

  - `attributes.description` (string,null)

  - `relationships` (object)

  - `relationships.parentFolder` (object)

  - `relationships.parentFolder.data` (object)

  - `relationships.parentFolder.data.id` (string, required)

  - `relationships.parentFolder.data.type` (string, required)
    Enum: same as `type` (1 values)

## Response 200 fields (application/vnd.treasuredata.v1+json):

  - `data` (object, required)

  - `data.id` (string, required)

  - `data.type` (string, required)
    Enum: same as `type` (1 values)

  - `data.attributes` (object, required)

  - `data.attributes.audienceId` (string, required)
    ID of the parent audience. For composable folders this carries
the composable audience id; the complete-vs-composable
discriminator lives on the parent audience entity, not on the
folder.

  - `data.attributes.name` (string, required)

  - `data.attributes.description` (string,null, required)

  - `data.attributes.createdAt` (string, required)

  - `data.attributes.updatedAt` (string, required)

  - `data.attributes.enrichments` (object,null)

  - `data.attributes.rule` (object,null)

  - `data.attributes.permissions` (object, required)

  - `data.attributes.permissions.view` (boolean)

  - `data.attributes.permissions.edit` (boolean)

  - `data.relationships` (object, required)

  - `data.relationships.children` (object)

  - `data.relationships.children.data` (array)

  - `data.relationships.children.data.data` (object)

  - `data.relationships.children.data.data.id` (string, required)

  - `data.relationships.children.data.data.type` (string, required)
    Enum: "folder-segment", "segment-batch", "segment-realtime", "composable-segment", "funnel", "predictive-segment", "token", "journey"

  - `data.relationships.parentFolder` (object)

  - `data.relationships.parentFolder.data` (object,null)

  - `data.relationships.parentFolder.data.id` (string, required)

  - `data.relationships.parentFolder.data.type` (string, required)
    Enum: same as `type` (1 values)

  - `data.relationships.createdBy` (object)

  - `data.relationships.createdBy.data` (object,null)

  - `data.relationships.createdBy.data.id` (string, required)

  - `data.relationships.createdBy.data.type` (string, required)
    Enum: "user"

  - `data.relationships.updatedBy` (object)

  - `included` (array, required)

  - `included.id` (string, required)

  - `included.type` (string, required)
    Enum: same as `data.relationships.createdBy.data.type` (1 values)

  - `included.attributes` (object, required)

  - `included.attributes.tdUserId` (string, required)

  - `included.attributes.name` (string, required)