---
title: "PATCH /scs/v2/update"
method: PATCH
path: "/scs/v2/update"
tags: ["File/Folder Operations"]
---

# PATCH /scs/v2/update

`PATCH /scs/v2/update`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/scs/v2/update`
- Auth: none declared

Update folders and files. For a folder, you may update description, writeAcl, readAcl, classificationMarking, and tags. For a file, you may update description, classificationMarking, and tags. A specific role is required to perform this service operation. Please contact the UDL team for assistance.

## Query parameters

- `path` string, required
- `sendNotification` boolean

## Request body

- ScsEntityUserProvided: An SCS file or folder.
  - `id` string: Unique identifier for document.
  - `classificationMarking` string: Classification marking of the folder or file in IC/CAPCO portion-marked format.
  - `createdBy` string: The creator of this document. Can be a person or a software entity.
  - `createdAt` string: The time at which this document was created, represented in UTC ISO format.
  - `updatedBy` string: The person or software entity who updated this document most recently.
  - `updatedAt` string: The time at which this document was most recently updated, represented in UTC ISO format.
  - `filename` string: The name of this document. Applicable to files and folders.
  - `filePath` string: The absolute path to this document.
  - `parentPath` string: The parent folder of this document. If this document is a root-level folder then the parent path is "/".
  - `pathType` 'file' | 'folder': The type of this document.
  - `keywords` string: Optional. Any keywords associated with this document. Only applicable to files whose contents are indexed (e.g. text files, PDFs).
  - `description` string: Optional description for the file or folder.
  - `readAcl` string: For folders only. Comma separated list of user and group ids that should have read access on this folder and the items nested in it.
  - `writeAcl` string: For folders only. Comma separated list of user and group ids that should have write access on this folder and the items nested in it.
  - `tags` string[]: Array of provider/source specific tags for this data, used for implementing data owner conditional access controls to restrict access to the data.
  - `attachment` AttachmentUserProvided
    - `date` string: The time at which this attachment was created, represented in UTC ISO format.
    - `keywords` string: Any keywords associated with this document. Only applicable to files whose contents are indexed (e.g. text files, PDFs).
    - `content_type` string: The document's MIME-type (if applicable).
    - `author` string: The creator of this document. Can be a person or a software entity.
    - `language` string: The human language of the document, if discernible.
    - `title` string: The title of the document.
    - `content_length` integer: The length of the document, in bytes.
  - `size` integer: Size of this document in bytes.
  - `deleteOn` integer: Time at which this document should be automatically deleted. Represented in milliseconds since Unix epoch.

## Response `204`

Success

## Other responses

- `400`: Bad Request. See message for details
- `401`: Unauthorized
- `403`: User not authorized to perform update. See message for details.
- `500`: Internal Server Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-10-23** `09bd422d5ac1`: 1 info
  - added the non-success response with the status `401`
- **2025-09-26** `45631f9bb3f0`: 14 info
  - api tag `File/Folder Operations` added
  - api tag `SCS V2` removed
  - added the new optional request property `attachment`
  - added the new optional request property `createdAt`
  - …10 more
- **2025-05-29** `4e1cbc17e814`: 2 info
  - added the new optional `query` request parameter `sendNotification`
  - added the new optional request property `deleteOn`
- **2025-04-16** `75f764c843a9`: 13 warning
  - removed the request property `attachment`
  - removed the request property `createdAt`
  - removed the request property `createdBy`
  - removed the request property `data`
  - …9 more

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/scs/v2/update/patch.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)