---
title: "POST /scs/v2/folder"
method: POST
path: "/scs/v2/folder"
tags: ["File/Folder Operations"]
---

# POST /scs/v2/folder

`POST /scs/v2/folder`

## Request

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

Creates all folders in provided path that don't exist. Can be used to create a single folder or a new folder structure. Provided classificationMarking, description, writeAcl, readAcl, and tags are applied to the deepest folder in the provided path. If parent folders are created by this request, each parent folder will be created with the same 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 `201`

Success

## Other responses

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

## 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/folder/post.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)