Member Roles

Member role assignment and management

Get member roles

get

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role

Retrieve member role assignments with approval information

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

roleIdstringOptional

Filter by role ID

roleNamestringOptional

Filter by role name

statusstringOptional

Filter by status

startDatestring · dateOptional

Start date filter

endDatestring · dateOptional

End date filter

memberIdstringOptional

Filter by member ID

memberNamestringOptional

Filter by member name

pageSizestringOptional

Number of items per page

pageNumberstringOptional

Page number

sortBystringOptional

Sort field

sortOrderstring · enumOptional

Sort order

Possible values:

approvalStatusstringOptional

Filter by approval status

searchMemberNamestringOptional

Search by member name

Responses

200

Member roles retrieved successfully

application/json

400

Validation error

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

get

/rbac/member-role

HTTPcURLJavaScriptPython

GET /v1/rbac/member-role HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "pagination": {
    "currentPage": 1,
    "totalPages": 10,
    "totalItems": 100,
    "itemsPerPage": 10,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "data": [
    {
      "memberRoleId": "123e4567-e89b-12d3-a456-426614174000",
      "memberId": "123e4567-e89b-12d3-a456-426614174000",
      "roleId": "123e4567-e89b-12d3-a456-426614174000",
      "memberName": "text",
      "roleName": "text",
      "status": "active",
      "startDateTime": "2025-12-16T02:48:01.775Z",
      "endDateTime": "2025-12-16T02:48:01.775Z",
      "firstApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
      "secondApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
      "firstApprovalDate": "2025-12-16T02:48:01.775Z",
      "secondApprovalDate": "2025-12-16T02:48:01.775Z",
      "firstApprovalStatus": true,
      "secondApprovalStatus": true,
      "approvalStatus": "pending",
      "approvingRoleId": "123e4567-e89b-12d3-a456-426614174000",
      "approvingRoleName": "text",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000",
      "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-12-16T02:48:01.775Z",
      "updatedAt": "2025-12-16T02:48:01.775Z"
    }
  ]
}

Create member role

post

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role

Assign a role to a member

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

memberIdstring · uuidRequired

Member ID

roleIdstring · uuidRequired

Role ID

Responses

201

Member role created successfully

application/json

400

Validation error

application/json

500

Internal server error

application/json

post

/rbac/member-role

HTTPcURLJavaScriptPython

POST /v1/rbac/member-role HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "memberId": "123e4567-e89b-12d3-a456-426614174000",
  "roleId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "success": true,
  "message": "Member role created successfully",
  "data": {
    "memberRoleId": "123e4567-e89b-12d3-a456-426614174000",
    "memberId": "123e4567-e89b-12d3-a456-426614174000",
    "roleId": "123e4567-e89b-12d3-a456-426614174000",
    "memberName": "text",
    "roleName": "text",
    "status": "active",
    "startDateTime": "2025-12-16T02:48:01.775Z",
    "endDateTime": "2025-12-16T02:48:01.775Z",
    "firstApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
    "secondApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
    "firstApprovalDate": "2025-12-16T02:48:01.775Z",
    "secondApprovalDate": "2025-12-16T02:48:01.775Z",
    "firstApprovalStatus": true,
    "secondApprovalStatus": true,
    "approvalStatus": "pending",
    "approvingRoleId": "123e4567-e89b-12d3-a456-426614174000",
    "approvingRoleName": "text",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000",
    "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2025-12-16T02:48:01.775Z",
    "updatedAt": "2025-12-16T02:48:01.775Z"
  }
}

Update member role

put

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role/{memberRoleId}

Update member role assignment and approval status

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

memberRoleIdstring · uuidRequired

Member role ID

Body

application/json

roleIdstring · uuidOptional

roleNamestringOptional

statusstring · enumOptionalPossible values:

startDateTimestring · date-timeOptional

endDateTimestring · date-timeOptional

approvingRoleIdstring · uuidOptional

Responses

200

Member role updated successfully

application/json

400

Validation error

application/json

500

Internal server error

application/json

put

/rbac/member-role/{memberRoleId}

HTTPcURLJavaScriptPython

PUT /v1/rbac/member-role/{memberRoleId} HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 226

{
  "roleId": "123e4567-e89b-12d3-a456-426614174000",
  "roleName": "text",
  "status": "active",
  "startDateTime": "2025-12-16T02:48:01.775Z",
  "endDateTime": "2025-12-16T02:48:01.775Z",
  "approvingRoleId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "success": true,
  "message": "Member role updated successfully",
  "data": {
    "memberRoleId": "123e4567-e89b-12d3-a456-426614174000",
    "memberId": "123e4567-e89b-12d3-a456-426614174000",
    "roleId": "123e4567-e89b-12d3-a456-426614174000",
    "memberName": "text",
    "roleName": "text",
    "status": "active",
    "startDateTime": "2025-12-16T02:48:01.775Z",
    "endDateTime": "2025-12-16T02:48:01.775Z",
    "firstApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
    "secondApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
    "firstApprovalDate": "2025-12-16T02:48:01.775Z",
    "secondApprovalDate": "2025-12-16T02:48:01.775Z",
    "firstApprovalStatus": true,
    "secondApprovalStatus": true,
    "approvalStatus": "pending",
    "approvingRoleId": "123e4567-e89b-12d3-a456-426614174000",
    "approvingRoleName": "text",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000",
    "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2025-12-16T02:48:01.775Z",
    "updatedAt": "2025-12-16T02:48:01.775Z"
  },
  "updatePOMResult": {}
}

Get unique member roles

get

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role/unique

Retrieve unique member role data

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

memberRoleIdstringOptional

Filter by member role ID

memberIdstringOptional

Filter by member ID

roleIdstringOptional

Filter by role ID

statusstringOptional

Filter by status

Responses

200

Unique member roles retrieved successfully

application/json

400

Validation error

application/json

500

Internal server error

application/json

get

/rbac/member-role/unique

HTTPcURLJavaScriptPython

GET /v1/rbac/member-role/unique HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": [
    {
      "memberRoleId": "123e4567-e89b-12d3-a456-426614174000",
      "memberId": "123e4567-e89b-12d3-a456-426614174000",
      "roleId": "123e4567-e89b-12d3-a456-426614174000",
      "memberName": "text",
      "roleName": "text",
      "status": "active",
      "startDateTime": "2025-12-16T02:48:01.775Z",
      "endDateTime": "2025-12-16T02:48:01.775Z",
      "firstApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
      "secondApprovalBy": "123e4567-e89b-12d3-a456-426614174000",
      "firstApprovalDate": "2025-12-16T02:48:01.775Z",
      "secondApprovalDate": "2025-12-16T02:48:01.775Z",
      "firstApprovalStatus": true,
      "secondApprovalStatus": true,
      "approvalStatus": "pending",
      "approvingRoleId": "123e4567-e89b-12d3-a456-426614174000",
      "approvingRoleName": "text",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000",
      "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-12-16T02:48:01.775Z",
      "updatedAt": "2025-12-16T02:48:01.775Z"
    }
  ]
}

Bulk member role actions

post

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role/actions

Perform bulk actions on member roles (approve/reject)

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

memberRoleIdsstring · uuid[]Optional

Array of member role IDs

actionbooleanOptional

Action to perform (true for approve, false for reject)

approvingRoleIdstring · uuidOptional

ID of the approving role

Responses

200

Member role actions completed successfully

application/json

400

Validation error

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

post

/rbac/member-role/actions

HTTPcURLJavaScriptPython

POST /v1/rbac/member-role/actions HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "memberRoleIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "action": true,
  "approvingRoleId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "success": true,
  "message": "Member role actions completed successfully"
}

Get member role approving count

get

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role/approving-count

Get count of member roles pending approval

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Approving count retrieved successfully

application/json

500

Internal server error

application/json

get

/rbac/member-role/approving-count

HTTPcURLJavaScriptPython

GET /v1/rbac/member-role/approving-count HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "Member role approving count",
  "count": 5
}

Get member role status count

get

https://api.example.com/v1https://staging-api.example.com/v1

/rbac/member-role/status-count

Get count of member roles by status

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateOptional

Start date filter

endDatestring · dateOptional

End date filter

Responses

200

Status count retrieved successfully

application/json

500

Internal server error

application/json

get

/rbac/member-role/status-count

HTTPcURLJavaScriptPython

GET /v1/rbac/member-role/status-count HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "Member role status count",
  "data": {}
}