Skip to content
Okta Identity Governance
/
Management APIs
/
/
Add the resources to a co...

Add the resources to a collection
deprecated

Request

Beta
OAuth 2.0 scope:
  • okta.governance.collections.manage
Admin roles:
  • APP_ADMIN

Adds the resources to a collection

Note: This endpoint is deprecated. Use addResourcesToCollectionV2 instead.

Path
collectionIdstringrequired

Unique identifier for the collection

Bodyapplication/json
Array [
resourceOrnstring, (okta-resource-orn)(app-resource-orn)required

The ORN identifier for a specific app. Other resource types aren't supported.

See the supported-resources endpoint for reference.

entitlementsArray of objects(entitlements-creatable)

Collection of entitlements and associated value identifiers

]
curl -i -X POST \
  'https://subdomain.okta.com/governance/api/v1/collections/{collectionId}/resources' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "resourceOrn": "orn:okta:idp:00ofsdghasfhas54wewe:apps:salesforce:0oafxqCAJWWGELFTYASJ",
      "entitlements": [
        {
          "id": "espo3v6xlwdtEX2il1d6",
          "values": [
            {
              "id": "ento3v6xmkviXCltm1d6"
            }
          ]
        },
        {
          "id": "esp4rg7fkom0c3AsX8g6",
          "values": [
            {
              "id": "ent4rg7fltWSgrlDT8g6"
            }
          ]
        }
      ]
    },
    {
      "resourceOrn": "orn:okta:idp:00o11edPwGqbUrsDm0g4:apps:google:0oafxqDFHASFGZGSERDHA"
    },
    {
      "resourceOrn": "orn:okta:idp:0034t89uq4u0q54u80q2:apps:netsuite:0oasdSD~GAVXCBZSDFG",
      "entitlements": [
        {
          "id": "espo3v6xlwdtEX2il1d6",
          "values": [
            {
              "id": "ento3v6xmkviXCltm1d6"
            },
            {
              "id": "ento3v6xk6nOq7lm51d6"
            }
          ]
        },
        {
          "id": "esp4rg7fkom0c3AsX8g6",
          "values": [
            {
              "id": "ent4rg7fltWSgrlDT8g6"
            }
          ]
        }
      ]
    }
  ]'

Responses

A successful add resources to collection list response

Headers
X-Rate-Limit-Limitinteger, >= 1required

The rate-limit ceiling for the current request

Example:60
X-Rate-Limit-Remaininginteger, >= 0required

The number of requests left for the current rate-limit window

Example:60
X-Rate-Limit-Resetinteger, >= 0required

The time when the rate limit resets, specified in UTC epoch time (in seconds)

Example:1609459200
Bodyapplication/json
dataArray of objects(collection-resource-full)
metadataobject(list-metadata)

Metadata for the list response

Response

List of resources in a collection

{
  "data": [
    { … },
    { … },
    { … }
  ],
  "_links": {
    "next": { … },
    "self": { … }
  },
  "metadata": {
    "count": 3
  }
}