Get public file system items
Retrieves items (assets and folders) from a public file system at the root level. No authentication required. Supports index pagination (default) or cursor pagination via `paginate=cursor`; the cursor-only options are rejected with 400 when `paginate` is `index`, and `page` is rejected when `paginate` is `cursor`. Populated resources are reduced to the public allowlist before being returned. When the release was created with `hideCreators: true`, each item's `creator` / `resourceCreator` / `resourceCreatorId` fields are omitted.
Retrieves items (assets and folders) from a public file system at the root level. No authentication required. Supports index pagination (default) or cursor pagination via paginate=cursor; the cursor-only options are rejected with 400 when paginate is index, and page is rejected when paginate is cursor. Populated resources are reduced to the public allowlist before being returned. When the release was created with hideCreators: true, each item's creator / resourceCreator / resourceCreatorId fields are omitted.
Path Parameters
The 10-character access token for the public file system.
^[a-zA-Z0-9]{10}$10 <= length <= 10Query Parameters
Pagination type to use
"index"Value in
- "cursor"
- "index"
Whether to search recursively through subfolders
Restrict results to these asset/folder IDs. A single value or repeated parameter.
[]Restrict results to these resource slugs. A single value or repeated parameter.
[]Filter by resource type
Value in
- "asset"
- "folder"
Filter by the ID of the user who created the resource
uuidFilter by media types. A single value or repeated parameter.
[]Filter by resource status
"active"Value in
- "active"
- "pendingDelete"
Search items by name
length <= 100Sort order, e.g. sort[name]=1. Keys are mapped onto the underlying file-system item fields.
Default
{ "id": -1}Number of items per page
1 <= value <= 10010Cursor for pagination (cursor pagination only; rejected when paginate=index)
Whether to paginate in reverse order (cursor pagination only)
Whether to include total counts (cursor pagination only)
Whether to include the cursor record itself (cursor pagination only)
Start at a specific file-system item ID (cursor pagination only)
uuidWhether to include the startAt record (cursor pagination only)
Page number (index pagination only; rejected when paginate=cursor)
1 <= valueResponse Body
application/json
application/json
curl -X GET "https://example.com/public/abc123xyz0/files"{ "page": 0, "limit": 0, "totalPages": 0, "totalResults": 0, "queryAt": 0, "results": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6", "resourceType": "asset", "resourceName": "string", "resourceSlug": "string", "resourceCreatorId": "b999e32f-d7f6-4b84-a6e4-838d107690fd", "resourceTags": [ "2c6ab259-75b1-40bd-909b-bdecda587146" ], "resourceMediaType": "string", "resourceStatus": "active", "resourceCreatedAt": "2019-08-24T14:15:22Z", "sizeInBytes": 0, "path": "string", "itemPath": "string", "pathType": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "resource": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "ownerResourceId": "7d5ad1db-89f9-42df-868c-86a72347ae1c", "ownerResourceType": "workspace", "creatorId": "688ebf54-d343-4104-8711-82c2feac534a", "creator": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" }, "fileSystemPaths": [ "string" ], "basePath": "string", "noFileSystem": false, "keyPath": "string", "checksum": "string", "checksumAlgorithm": "md5", "name": "string", "slug": "string", "functionType": "attachment", "mediaType": "image", "tags": [], "files": [ { "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8", "keyPath": "/project/asset/file123.jpg", "checksum": "string", "checksumAlgorithm": "md5", "name": "string", "functionType": "original", "sizeInBytes": 0, "status": "active", "meta": {}, "createdAt": 1678886400000, "updatedAt": 1678886400000 } ], "chats": { "creatorLastMessageAt": "2019-08-24T14:15:22Z", "reviewerLastMessageAt": "2019-08-24T14:15:22Z", "creator": "1dccd4a6-75d2-43aa-a088-76d941f1b60a", "reviewer": "a4b7b7a3-a1d0-4e27-9161-fa5679d1e0d6" }, "expectedUploadSizeInMB": 0, "sizeInBytes": 0, "visibility": [ "creator" ], "publishedOn": 1678886400000, "publisherId": "f1ba8124-cabe-46cd-b4f9-1189594ff7b3", "publisher": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" }, "hasActivePublicLink": false, "hasActivePublicFileSystem": false, "everPublic": false, "publicFileSystemIds": [ "3a3392f6-5ad7-429c-8b57-759911bd1423" ], "publicAssetLinkIds": [ "35788e46-f1b0-471c-b8ec-69afab5a9e64" ], "submissionFileSystemIds": [ "c658ae43-33f0-4032-85f0-ea3242de6509" ], "aiGenerated": false, "promotedFromAssetId": "c833ed16-de04-406f-a750-9ed1e24820b3", "contentSnippet": "string", "status": "active", "meta": {}, "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46", "inheritance": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6", "resourceType": "string", "inheritance": { "0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b": "workspace", "0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6c": "project" }, "inheritanceInverted": { "property1": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "property2": "497f6eca-6276-4993-bfeb-53cbbbba6f08" }, "path": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }, "createdAt": 1678886400000, "updatedAt": 1678886400000 } } ]}