Create

Create

client.Apps.Entitlements.New(ctx, appID, body) (*AppEntitlementViewC1APIAppV1AppEntitlementViewExpandedarrayAppEntitlementNewResponse, error)

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

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

Parameters

appIDstring

The appId field.

bodyDisplayNamefieldAliasfieldAppEntitlementOwnerIDsfieldAppResourceIDfieldAppResourceTypeIDfieldCertifyPolicyIDfieldComplianceFrameworkValueIDsfieldDescriptionfieldDurationGrantfieldDurationUnsetfieldEmergencyGrantEnabledfieldEmergencyGrantPolicyIDfieldExpandMaskfieldGrantPolicyIDfieldMatchBatonIDfieldOverrideAccessRequestsDefaultsfieldProvisionPolicyfieldPurposefieldRevokePolicyIDfieldRiskLevelValueIDfieldSlugfieldAppEntitlementNewParams

Hide ParametersShow Parameters

DisplayNamefield

param.Field[string]

The displayName field.

Aliasfield

optional

param.Field[string]

The alias field.

AppEntitlementOwnerIDsfield

optional

param.Field[[]string]

The appEntitlementOwnerIds field.

AppResourceIDfield

optional

param.Field[string]

The appResourceId field.

AppResourceTypeIDfield

optional

param.Field[string]

The appResourceTypeId field.

CertifyPolicyIDfield

optional

param.Field[string]

The certifyPolicyId field.

ComplianceFrameworkValueIDsfield

optional

param.Field[[]string]

The complianceFrameworkValueIds field.

Descriptionfield

optional

param.Field[string]

The description field.

DurationGrantfield

optional

param.Field[string]

formatduration

DurationUnsetfield

optional

param.Field[any]

EmergencyGrantEnabledfield

optional

param.Field[bool]

The emergencyGrantEnabled field.

EmergencyGrantPolicyIDfield

optional

param.Field[string]

The emergencyGrantPolicyId field.

ExpandMaskfield

optional

param.Field[PathsarrayC1APIAppV1AppEntitlementExpandMask]

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

GrantPolicyIDfield

optional

param.Field[string]

The grantPolicyId field.

MatchBatonIDfield

optional

param.Field[string]

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

OverrideAccessRequestsDefaultsfield

optional

param.Field[bool]

The overrideAccessRequestsDefaults field.

ProvisionPolicyfield

optional

param.Field[ConnectorC1APIPolicyV1ProvisionPolicyConnectorDelegatedC1APIPolicyV1ProvisionPolicyDelegatedExternalTicketC1APIPolicyV1ProvisionPolicyExternalTicketManualC1APIPolicyV1ProvisionPolicyManualUnconfiguredanyWebhookC1APIPolicyV1ProvisionPolicyWebhookC1APIPolicyV1ProvisionPolicy]

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

Purposefield

optional

param.Field[AppEntitlementNewParamsPurpose]

The purpose field.

Hide ParametersShow Parameters

AppEntitlementNewParamsPurposeAppEntitlementPurposeValueUnspecifiedconst

AppEntitlementNewParamsPurpose

"APP_ENTITLEMENT_PURPOSE_VALUE_UNSPECIFIED"

AppEntitlementNewParamsPurposeAppEntitlementPurposeValueAssignmentconst

AppEntitlementNewParamsPurpose

"APP_ENTITLEMENT_PURPOSE_VALUE_ASSIGNMENT"

AppEntitlementNewParamsPurposeAppEntitlementPurposeValuePermissionconst

AppEntitlementNewParamsPurpose

"APP_ENTITLEMENT_PURPOSE_VALUE_PERMISSION"

RevokePolicyIDfield

optional

param.Field[string]

The revokePolicyId field.

RiskLevelValueIDfield

optional

param.Field[string]

The riskLevelValueId field.

Slugfield

optional

param.Field[string]

The slug field.

Returns

AppEntitlementNewResponsestruct

The CreateAppEntitlementResponse message.

Hide ParametersShow Parameters

AppEntitlementViewAppEntitlementC1APIAppV1AppEntitlementAppPathstringAppResourcePathstringAppResourceTypePathstringC1APIAppV1AppEntitlementView

optional

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

Expandedarray

optional

[]AppEntitlementNewResponseExpanded

The expanded field.

Hide ParametersShow Parameters

Typestring

optional

The type of the serialized message.

Request example Go

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/-go"
  "github.com/stainless-sdks/-go/option"
)

func main() {
  client := conductoronesdk.NewClient(
    option.WithAPIKey("My API Key"),
  )
  entitlement, err := client.Apps.Entitlements.New(
    context.TODO(),
    "app_id",
    conductoronesdk.AppEntitlementNewParams{
      DisplayName: "displayName",
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", entitlement.AppEntitlementView)
}

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"
    }
  ]
}