Get assets for a project with specified visibility
Retrieves assets for a project filtered by visibility level, optionally with their chats, with support for both cursor and index-based pagination. Requires `canGetCreatorAssets` for `creator` and `canGetReviewerAssets` for `reviewer`. Cursor-only parameters are rejected with index pagination, and `page`, `createdBefore`, `createdAfter` are rejected with cursor pagination.
Retrieves assets for a project filtered by visibility level, optionally with their chats, with support for both cursor and index-based pagination. Requires canGetCreatorAssets for creator and canGetReviewerAssets for reviewer. Cursor-only parameters are rejected with index pagination, and page, createdBefore, createdAfter are rejected with cursor pagination.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: projects:read
Path Parameters
Unique ID of the project.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$uuidWhich tree to operate on — the creator tree or the reviewer tree.
Value in
- "creator"
- "reviewer"
Query Parameters
Pagination mode. Cursor-only parameters are rejected when index; page is rejected when cursor.
"index"Value in
- "cursor"
- "index"
Search assets by name
length <= 100Filter assets by media type (single value or array).
[]Timestamp or ID indicating the upper bound of result creation time. A numeric timestamp is Unix time in milliseconds; a value that looks like seconds is rejected with a 400 validationError. You may preface an ID with a '+' to make the results inclusive of that result Meaning <= instead of just <.
Timestamp or ID indicating the lower bound of result creation time. A numeric timestamp is Unix time in milliseconds; a value that looks like seconds is rejected with a 400 validationError. You may preface an ID with a '+' to make the results inclusive of that result Meaning <= instead of just <.
Sorting criteria for assets
Number of results per page
value <= 2020Page number (only accepted with paginate=index).
1Cursor for pagination (only accepted with paginate=cursor).
ID of the record to start pagination from (only accepted with paginate=cursor).
uuidIf true, includes the startAt record in the results (only accepted with paginate=cursor).
trueIf true, paginates in reverse order (only accepted with paginate=cursor).
falseIf true, includes count information (only accepted with paginate=cursor).
falseIf true, includes the cursor record in results (only accepted with paginate=cursor).
falseInclude associated chats in the response
trueSorting criteria for embedded chat messages
Default
{ "id": -1}Sorting criteria for embedded chat replies
Default
{ "id": -1}Maximum number of embedded chat messages to return per chat
value <= 10010Maximum number of embedded replies to return per message
value <= 10010If true, hides assets with no chat messages
falseRestrict to assets in this folder.
uuidnullIf true, ignores folder placement when listing assets.
falseResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/assets/creator"{ "page": 0, "limit": 0, "totalPages": 0, "totalResults": 0, "queryAt": 0, "results": [ { "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": "sha256", "contentSha256": "string", "originalName": "string", "originalExtension": "mov", "originalSizeInBytes": 0, "originalState": "stored", "processingCompletedAt": 0, "keepOriginal": true, "pruneAfter": 0, "pruneRequestedById": "106ef251-f0bc-45b7-8342-6f3d10dbd865", "pruneReason": "manual", "prunedAt": 0, "reattachStartedAt": 0, "reattachById": "250e32ee-9f86-4efa-94d3-2c18a10241d1", "reattachUploadId": "string", "pruneAttempts": 0, "pruneError": "string", "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 } ], "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, "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" } } ]}