The Collections - V2 API allows you to manage collections of resources, such as apps, groups, and push groups. Apps included in the collection can opt in or out of Entitlement Management (EM). You can directly assign resource collections to users (principals) or create access request conditions to streamline access to collections. See Resource collection in the product documentation.
Note: You must enable the Extend resource collections with Okta groups, Okta push groups, and non-Entitlement Management apps feature to use the Collections - V2 APIs. See Manage Early Access and Beta features.
Creates an empty resource collection
curl -i -X POST \
https://okta-subdomain.pixtulate.com/governance/api/v2/collections \
-H 'Content-Type: application/json' \
-d '{
"name": "Core Engineering Access",
"description": "Birthright access for all FTE engineers"
}'Response to a successful resource collection creation operation
The id of the Okta user who created the resource
The ISO 8601 formatted date and time when the resource was created
The ISO 8601 formatted date and time when the object was last updated
The id of the Okta user who last updated the object
The id of the collection in ORN format.
{ "id": "cole8sBBMFDxPgcHx0g3", "name": "Core Engineering Access", "orn": "orn:okta:governance:00o11rndFqmZ5rNfs0g4:collections:cole8sBBMFDxPgcHx0g3", "description": "Birthright access for all FTE engineers", "created": "2024-07-24T14:15:22Z", "createdBy": "00ub0oNGTSWTBKOLGLNR", "lastUpdated": "2024-07-24T14:15:22Z", "lastUpdatedBy": "00ub0oNGTSWTBKOLGLNR", "_links": { "resources": { … } } }