The Collections API allows you to manage resource collections that contain apps and entitlements. Apps must opt in to Entitlement Management (EM) before they can be added to a collection.
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.
Notes:
- For non-EM apps, groups, and push group support in collections, use the Collections - V2 APIs.
- If you enable the Extend resource collections with Okta groups, Okta push groups, and non-Entitlement Management apps feature in your org (see Manage Early Access and Beta features), you must use the Collections - V2 API instead of the Collections API. With this feature enabled, certain method requests to the original Collections API may return unexpected responses. Nevertheless, collections managed through either version of the API can still be used within access certification campaigns or access requests.
Creates an empty resource collection
curl -i -X POST \
https://okta-subdomain.pixtulate.com/governance/api/v1/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:col4a6Rpz3FCxDEBp0g3", "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": { … } } }