Access Management

Create an entitlement

POST https://{tenant}.atomicwork.com/api/v1/iga/entitlements

Create a new identity entitlement. Requires app_id and type. The entitlement can then be associated with policies and granted to users.

Authorization

X-Api-Keyheaderstringrequired

API key authentication.

Headers

X-Workspace-Idheaderstring

Body

namebodystringrequired

Name of the entitlement

descriptionbodystring

Description of the entitlement

app_idbodyintegerrequired

ID of the identity resource app this entitlement belongs to

statusbodyenum (string)

Status of the entitlement. Defaults to PUBLISHED if not specified.

Allowed valuesUNPUBLISHEDPUBLISHED

provisioning_configbodyobject

properties

deprovisioning_configbodyobject

properties

Response

200

Successful response

cURL

curl -X POST 'https://{tenant}.atomicwork.com/api/v1/iga/entitlements' \
  -H 'X-Api-Key: <api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "string", "description": "string", "app_id": 0, "status": "UNPUBLISHED", "provisioning_config": {"provider": "OKTA", "type": "OKTA_GROUP_PROVISIONING", "value": {"label": "string", "icon": {"name": "\u2026", "type": "\u2026", "url": "\u2026"}, "value": "string"}}, "deprovisioning_config": {"provider": "OKTA", "type": "OKTA_GROUP_DEPROVISIONING", "value": {"value": "string", "label": "string", "icon": {"name": "\u2026", "type": "\u2026", "url": "\u2026"}}}}'