Nurama Developers
Membership

Return membership of a project. Membership retrieved are determined by a user's role in the project. For example, reviewers can only see reviewers.

Returns a paginated, per-user membership report for the project (same shape as the workspace report). Requires `canGetProjectMembership`; the roles visible depend on the caller's inherited permissions in the project. Only one of the name sorts may be used at a time.

GET
/memberships/project/{projectId}

Returns a paginated, per-user membership report for the project (same shape as the workspace report). Requires canGetProjectMembership; the roles visible depend on the caller's inherited permissions in the project. Only one of the name sorts may be used at a time.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

projectId*string

The ID of the project to retrieve membership records for.

Formatuuid

Query Parameters

nameSearch?string

Optional name search to filter membership records by user names.

Lengthlength <= 105
Defaultnull
isBillable?boolean

Flag to filter memberships based on billable status.

Defaultfalse
sort?

Sorting criteria for the membership records.

limit?number

Maximum number of membership records to return (default 20, max limits.membership.maxMembershipRecords).

Rangevalue <= 100000
Default20
page?number

Page number for pagination (default 1).

Default1

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/memberships/project/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "page": 0,  "limit": 0,  "totalPages": 0,  "totalResults": 0,  "queryAt": 0,  "results": [    {      "user": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "firstName": "string",        "lastName": "string",        "displayName": "string",        "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",        "color": "string",        "awards": [          "staff"        ],        "accountType": "standard"      },      "resources": [        {          "resourceId": "6733736868949390a715fc63",          "resourceType": "project",          "name": "Orn Group",          "roles": [            "reviewer, creator, projectOwner ect."          ]        }      ],      "membershipRecords": [        {          "id": "6733736868949390a715fc63",          "resourceId": "6733736868949390a715fc63",          "resourceType": "project",          "roles": [            "creator"          ]        }      ],      "createdAt": "2024-11-12T15:25:28.620Z",      "updatedAt": "2024-11-12T15:25:28.620Z",      "userId": "6733736768949390a715fac4",      "roles": [        "reviewer"      ],      "isBillable": false    }  ],  "totalCreators": 0,  "totalReviewers": 0}