File/Folder Operations

POST /scs/v2/search

Changed on

Operation to search for files in the Secure Content Store.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/scs/v2/search
  • Auth
    none declared

Query parameters

orderstring

The order in which entries should be sorted.

searchAfterstring

The starting point for pagination results, usually set to the value of the SEARCH_AFTER header returned in the previous request.

sizeinteger

The number of results to retrieve.

sortstring

The field on which to sort entries.

Request body

Response

Success

idstring

Unique identifier for document.

classificationMarkingstring

Classification marking of the folder or file in IC/CAPCO portion-marked format.

createdBystring

The creator of this document. Can be a person or a software entity.

createdAtstring

The time at which this document was created, represented in UTC ISO format.

updatedBystring

The person or software entity who updated this document most recently.

updatedAtstring

The time at which this document was most recently updated, represented in UTC ISO format.

filenamestring

The name of this document. Applicable to files and folders.

filePathstring

The absolute path to this document.

parentPathstring

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.

keywordsstring

Optional. Any keywords associated with this document. Only applicable to files whose contents are indexed (e.g. text files, PDFs).

descriptionstring

Optional description for the file or folder.

readAclstring

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.

writeAclstring

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.

tagsstring[]

Array of provider/source specific tags for this data, used for implementing data owner conditional access controls to restrict access to the data.

sizeinteger

Size of this document in bytes.

deleteOninteger

Time at which this document should be automatically deleted. Represented in milliseconds since Unix epoch.

Example response

[
  {
    "id": "/my-folder/",
    "classificationMarking": "U",
    "createdBy": "John.Doe",
    "createdAt": "2025-07-03T16:27:57.970Z",
    "updatedBy": "John.Doe",
    "updatedAt": "2025-07-03T16:27:57.970Z",
    "filename": "my-folder",
    "filePath": "/my-folder/sub-folder/",
    "parentPath": "/",
    "readAcl": "user.id1,group.id1",
    "writeAcl": "user.id1,group.id1",
    "tags": [
      "TAG1",
      "TAG2"
    ],
    "attachment": {
      "date": "2025-07-03T16:27:57.970Z",
      "content_type": "text/plain",
      "author": "John.Doe",
      "language": "en"
    }
  }
]

Changes

Some revisions have not been checked yet.