Role Resource Set Binding Members

The Role Resource Set Binding Members API provides operations to manage members in a Role Resource Set Binding.

List all role resource set binding members
OAuth 2.0: okta.roles.read

Lists all members of a role resource set binding with pagination support

Request
path Parameters
resourceSetIdOrLabel
required
string

id or label of the resource set

Example: iamoJDFKaJxGIr0oamd9g
roleIdOrLabel
required
string

id or label of the role

Example: cr0Yq6IJxGIr0ouum0g3
query Parameters
after
string

The cursor used for pagination. It represents the last privileged resource ID returned in the previous fetch operation.

Example: after=oprbuthToCeLWOBwh0g4
Responses
200

OK

403

Forbidden

404

Not Found

429

Too Many Requests

get/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/bindings/{roleIdOrLabel}/members
Request samples
Response samples
application/json
{}

Add more role resource set binding members
OAuth 2.0: okta.roles.manage

Adds more members to a role resource set binding

Request
path Parameters
resourceSetIdOrLabel
required
string

id or label of the resource set

Example: iamoJDFKaJxGIr0oamd9g
roleIdOrLabel
required
string

id or label of the role

Example: cr0Yq6IJxGIr0ouum0g3
Request Body schema: application/json
required
additions
Array of strings

A list of member resources to add to the role resource set binding

Responses
200

Success

400

Bad Request

403

Forbidden

404

Not Found

429

Too Many Requests

patch/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/bindings/{roleIdOrLabel}/members
Request samples
application/json
Response samples

Retrieve a role resource set binding member
OAuth 2.0: okta.roles.read

Retrieves a member (identified by memberId) that belongs to a role resource set binding

Request
path Parameters
resourceSetIdOrLabel
required
string

id or label of the resource set

Example: iamoJDFKaJxGIr0oamd9g
roleIdOrLabel
required
string

id or label of the role

Example: cr0Yq6IJxGIr0ouum0g3
memberId
required
string

id of the member

Example: irb1qe6PGuMc7Oh8N0g4
Responses
200

OK

403

Forbidden

404

Not Found

429

Too Many Requests

get/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/bindings/{roleIdOrLabel}/members/{memberId}
Request samples
Response samples
application/json
{}

Unassign a role resource set binding member
OAuth 2.0: okta.roles.manage

Unassigns a member (identified by memberId) from a role resource set binding

Request
path Parameters
resourceSetIdOrLabel
required
string

id or label of the resource set

Example: iamoJDFKaJxGIr0oamd9g
roleIdOrLabel
required
string

id or label of the role

Example: cr0Yq6IJxGIr0ouum0g3
memberId
required
string

id of the member

Example: irb1qe6PGuMc7Oh8N0g4
Responses
204

No Content

403

Forbidden

404

Not Found

429

Too Many Requests

delete/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/bindings/{roleIdOrLabel}/members/{memberId}
Request samples
Response samples
application/json
{
  • "errorCode": "E0000006",
  • "errorSummary": "You do not have permission to perform the requested action",
  • "errorLink": "E0000006",
  • "errorId": "sampleNUSD_8fdkFd8fs8SDBK",
  • "errorCauses": [ ]
}