Resource Set Resources

The Resource Set Resources API provides operations to manage Resources within a Resource Set. You can add or remove Resources in Resource Sets. See Supported Resources.

List all resource set resources
OAuth 2.0: okta.roles.read

Lists all Resources for the Resource Set

Request
path Parameters
resourceSetIdOrLabel
required
string

id or label of the resource set

Example: iamoJDFKaJxGIr0oamd9g
Responses
200

OK

403

Forbidden

404

Not Found

429

Too Many Requests

get/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/resources
Request samples 
Response samples 
application/json
{}
Add a resource set resource with conditions
Early Access
OAuth 2.0: okta.roles.manage
Adds a Resource with conditions for a Resource Set


Request 
path Parameters
resourceSetIdOrLabel
required
string
id or label of the resource set


 
 Example:  iamoJDFKaJxGIr0oamd9g
Request Body schema: application/json
required
resourceOrnOrUrl
required
string
Resource in ORN or REST API URL format


 
required
object (ResourceConditions) 
Conditions for further restricting a resource
 
object
Specific resources to exclude


 
okta:ORN
Array of strings
List of specific resources to exclude in ORN format


 
Responses 
200
Success


400
Bad Request


403
Forbidden


404
Not Found


429
Too Many Requests


post/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/resources
Request samples 
application/json
{
  • "resourceOrnOrUrl": "https://{yourOktaDomain}/api/v1/apps",
  • "conditions": {
    • "Exclude": {
      }
    }
}
Response samples 
application/json
{}
Add more Resources to a resource set
OAuth 2.0: okta.roles.manage
Adds more Resources to a Resource Set


Request 
path Parameters
resourceSetIdOrLabel
required
string
id or label of the resource set


 
 Example:  iamoJDFKaJxGIr0oamd9g
Request Body schema: application/json
required
additions
Array of strings
A list of resources to add to the Resource Set


 
Responses 
200
Success


400
Bad Request


403
Forbidden


404
Not Found


429
Too Many Requests


patch/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/resources
Request samples 
application/json
{}
Response samples 
application/json
{}
Retrieve a resource set resource
Early Access
OAuth 2.0: okta.roles.read
Retrieves a Resource identified by resourceId in a Resource Set


Request 
path Parameters
resourceSetIdOrLabel
required
string
id or label of the resource set


 
 Example:  iamoJDFKaJxGIr0oamd9g
resourceId
required
string
id of the Resource


 
 Example:  ire106sQKoHoXXsAe0g4
Responses 
200
Success


400
Bad Request


403
Forbidden


404
Not Found


429
Too Many Requests


get/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/resources/{resourceId}
Request samples 
Response samples 
application/json
{}
Replace the resource set resource conditions
Early Access
OAuth 2.0: okta.roles.manage
Replaces the conditions of a Resource identified by resourceId in a Resource Set


Request 
path Parameters
resourceSetIdOrLabel
required
string
id or label of the resource set


 
 Example:  iamoJDFKaJxGIr0oamd9g
resourceId
required
string
id of the Resource


 
 Example:  ire106sQKoHoXXsAe0g4
Request Body schema: application/json
required
object (ResourceConditions) 
Conditions for further restricting a resource
 
object
Specific resources to exclude


 
okta:ORN
Array of strings
List of specific resources to exclude in ORN format


 
Responses 
200
Success


400
Bad Request


403
Forbidden


404
Not Found


429
Too Many Requests


put/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/resources/{resourceId}
Request samples 
application/json
{
  • "conditions": {
    • "Exclude": {
      }
    }
}
Response samples 
application/json
{}
Delete a resource set resource
OAuth 2.0: okta.roles.manage
Deletes a Resource (identified by resourceId) from a Resource Set


Request 
path Parameters
resourceSetIdOrLabel
required
string
id or label of the resource set


 
 Example:  iamoJDFKaJxGIr0oamd9g
resourceId
required
string
id of the Resource


 
 Example:  ire106sQKoHoXXsAe0g4
Responses 
204
No Content


403
Forbidden


404
Not Found


429
Too Many Requests


delete/api/v1/iam/resource-sets/{resourceSetIdOrLabel}/resources/{resourceId}
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": [ ]
}