Create

Create

post/api/v1/apps/{app_id}/entitlements

Invokes the c1.api.app.v1.AppEntitlements.Create method.

Path Parameters

app_idstring

The appId field.

Body Parameters

displayNamestring

The displayName field.

aliasstring

optional

The alias field.

appEntitlementOwnerIdsarray of string

optional

The appEntitlementOwnerIds field.

appResourceIdstring

optional

The appResourceId field.

appResourceTypeIdstring

optional

The appResourceTypeId field.

certifyPolicyIdstring

optional

The certifyPolicyId field.

complianceFrameworkValueIdsarray of string

optional

The complianceFrameworkValueIds field.

descriptionstring

optional

The description field.

durationGrantstring

optional

formatduration

durationUnsetunknown

optional

emergencyGrantEnabledboolean

optional

The emergencyGrantEnabled field.

emergencyGrantPolicyIdstring

optional

The emergencyGrantPolicyId field.

expandMaskpathsarray of stringC1APIAppV1AppEntitlementExpandMask

optional

The app entitlement expand mask allows the user to get additional information when getting responses containing app entitlement views.

grantPolicyIdstring

optional

The grantPolicyId field.

matchBatonIdstring

optional

If supplied, it's implied that the entitlement is created before sync and needs to be merged with connector entitlement.

overrideAccessRequestsDefaultsboolean

optional

The overrideAccessRequestsDefaults field.

provisionPolicyconnectorobjectdelegatedobjectexternalTicketobjectmanualobjectunconfiguredunknownwebhookobjectC1APIPolicyV1ProvisionPolicy

optional

ProvisionPolicy is a oneOf that indicates how a provision step should be processed.

This message contains a oneof named typ. Only a single field of the following list may be set at a time:

• connector
• manual
• delegated
• webhook
• multiStep
• externalTicket
• unconfigured

purposeenum

optional

"APP_ENTITLEMENT_PURPOSE_VALUE_UNSPECIFIED" OR "APP_ENTITLEMENT_PURPOSE_VALUE_ASSIGNMENT" OR "APP_ENTITLEMENT_PURPOSE_VALUE_PERMISSION"

The purpose field.

Hide ParametersShow Parameters

"APP_ENTITLEMENT_PURPOSE_VALUE_UNSPECIFIED"

"APP_ENTITLEMENT_PURPOSE_VALUE_ASSIGNMENT"

"APP_ENTITLEMENT_PURPOSE_VALUE_PERMISSION"

revokePolicyIdstring

optional

The revokePolicyId field.

riskLevelValueIdstring

optional

The riskLevelValueId field.

slugstring

optional

The slug field.

Returns

appEntitlementViewappEntitlementC1APIAppV1AppEntitlementappPathstringappResourcePathstringappResourceTypePathstringC1APIAppV1AppEntitlementView

optional

The app entitlement view contains the serialized app entitlement and paths to objects referenced by the app entitlement.

expandedarray of object

optional

The expanded field.

Hide ParametersShow Parameters

@typestring

optional

The type of the serialized message.

Request example cURL

curl https://{tenantDomain}.conductor.one/api/v1/apps/$APP_ID/entitlements \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CONDUCTORONE_SDK_API_KEY" \
    -d '{
      "displayName": "displayName"
    }'

200 Example

{
  "appEntitlementView": {
    "appEntitlement": {
      "alias": "alias",
      "appId": "appId",
      "appResourceId": "appResourceId",
      "appResourceTypeId": "appResourceTypeId",
      "certifyPolicyId": "certifyPolicyId",
      "complianceFrameworkValueIds": [
        "string"
      ],
      "defaultValuesApplied": true,
      "deprovisionerPolicy": {
        "connector": {
          "account": {
            "config": {
              "foo": "bar"
            },
            "connectorId": "connectorId",
            "doNotSave": {},
            "saveToVault": {
              "vaultIds": [
                "string"
              ]
            },
            "schemaId": "schemaId"
          },
          "defaultBehavior": {
            "connectorId": "connectorId"
          },
          "deleteAccount": {
            "connectorId": "connectorId"
          }
        },
        "delegated": {
          "appId": "appId",
          "entitlementId": "entitlementId",
          "implicit": true
        },
        "externalTicket": {
          "appId": "appId",
          "connectorId": "connectorId",
          "externalTicketProvisionerConfigId": "externalTicketProvisionerConfigId",
          "instructions": "instructions"
        },
        "manual": {
          "instructions": "instructions",
          "userIds": [
            "string"
          ]
        },
        "unconfigured": {},
        "webhook": {
          "webhookId": "webhookId"
        }
      },
      "description": "description",
      "displayName": "displayName",
      "durationGrant": "durationGrant",
      "durationUnset": {},
      "emergencyGrantEnabled": true,
      "emergencyGrantPolicyId": "emergencyGrantPolicyId",
      "grantPolicyId": "grantPolicyId",
      "isManuallyManaged": true,
      "matchBatonId": "matchBatonId",
      "overrideAccessRequestsDefaults": true,
      "provisionerPolicy": {
        "connector": {
          "account": {
            "config": {
              "foo": "bar"
            },
            "connectorId": "connectorId",
            "doNotSave": {},
            "saveToVault": {
              "vaultIds": [
                "string"
              ]
            },
            "schemaId": "schemaId"
          },
          "defaultBehavior": {
            "connectorId": "connectorId"
          },
          "deleteAccount": {
            "connectorId": "connectorId"
          }
        },
        "delegated": {
          "appId": "appId",
          "entitlementId": "entitlementId",
          "implicit": true
        },
        "externalTicket": {
          "appId": "appId",
          "connectorId": "connectorId",
          "externalTicketProvisionerConfigId": "externalTicketProvisionerConfigId",
          "instructions": "instructions"
        },
        "manual": {
          "instructions": "instructions",
          "userIds": [
            "string"
          ]
        },
        "unconfigured": {},
        "webhook": {
          "webhookId": "webhookId"
        }
      },
      "purpose": "APP_ENTITLEMENT_PURPOSE_VALUE_UNSPECIFIED",
      "revokePolicyId": "revokePolicyId",
      "riskLevelValueId": "riskLevelValueId",
      "slug": "slug",
      "sourceConnectorIds": {
        "foo": "string"
      },
      "userEditedMask": "userEditedMask"
    },
    "appPath": "appPath",
    "appResourcePath": "appResourcePath",
    "appResourceTypePath": "appResourceTypePath"
  },
  "expanded": [
    {
      "@type": "@type"
    }
  ]
}