Nurama Developers
Projects

Get project feed with assets and chats

Retrieves a paginated feed of assets and their associated chats for a project. Requires `canGetCreatorAssets` for `creator` and `canGetReviewerAssets` for `reviewer`. Index pagination is the default; pass `paginate=cursor` for cursor pagination. Cursor-only parameters (`cursor`, `paginateReverse`, `includeCounts`, `includeCursorRecord`, `startAt`, `includeStartAtRecord`) are rejected with index pagination, and `page`, `createdBefore`, `createdAfter` are rejected with cursor pagination.

GET
/projects/{projectId}/feed/{visibility}

Retrieves a paginated feed of assets and their associated chats for a project. Requires canGetCreatorAssets for creator and canGetReviewerAssets for reviewer. Index pagination is the default; pass paginate=cursor for cursor pagination. Cursor-only parameters (cursor, paginateReverse, includeCounts, includeCursorRecord, startAt, includeStartAtRecord) are rejected with index pagination, and page, createdBefore, createdAfter are rejected with cursor pagination.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

projectId*string

Unique ID of the project.

Formatuuid
visibility*string

Which tree to operate on — the creator tree or the reviewer tree.

Value in

  • "creator"
  • "reviewer"

Query Parameters

paginate?string

Pagination mode. Cursor-only parameters are rejected when index; page is rejected when cursor.

Default"index"

Value in

  • "cursor"
  • "index"
mediaTypes?array<>|

Filter assets by media type (single value or array).

Default[]
sort?

Sorting criteria for the feed

Default

{  "id": -1}
limit?number

Number of results per page

Rangevalue <= 20
Default20
page?number

Page number (only accepted with paginate=index).

cursor?string

Cursor for pagination (only accepted with paginate=cursor).

paginateReverse?boolean

If true, paginates in reverse order (only accepted with paginate=cursor).

includeCounts?boolean

If true, includes count information (only accepted with paginate=cursor).

includeCursorRecord?boolean

If true, includes the cursor record in results (only accepted with paginate=cursor).

startAt?string

ID of the record to start pagination from (only accepted with paginate=cursor).

Formatuuid
includeStartAtRecord?boolean

If true, includes the startAt record in the results (only accepted with paginate=cursor).

nameSearch?string

Search assets by name

Lengthlength <= 100
Defaultnull
createdBefore?|

Timestamp or ID indicating the upper bound of result creation time. You may preface an ID with a '+' to make the results inclusive of that result Meaning <= instead of just <.

Defaultnull
createdAfter?|

Timestamp or ID indicating the lower bound of result creation time. You may preface an ID with a '+' to make the results inclusive of that result Meaning <= instead of just <.

Defaultnull
chatMessageSort?

Sorting criteria for embedded chat messages

Default

{  "id": -1}
chatReplySort?

Sorting criteria for embedded chat replies

Default

{  "id": -1}
chatMessageLimit?number

Maximum number of embedded chat messages to return per chat

Rangevalue <= 100
Default10
chatReplyLimit?number

Maximum number of embedded replies to return per message

Rangevalue <= 100
Default10
hideIfNoChatMessages?boolean

If true, hides assets with no chat messages

Defaultfalse
followedChatsOnly?boolean

If true, filters feed to show only chats the user is following

Defaultfalse

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/feed/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": "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        }      ],      "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"      }    }  ]}