Update

Update

client.Apps.Entitlements.Update(ctx, id, params) (*AppEntitlementViewC1APIAppV1AppEntitlementViewExpandedarrayAppEntitlementUpdateResponse, error)

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

Update an app entitlement by ID.

Parameters

idstring

The unique ID for the App Entitlement.

paramsAppIDfieldEntitlementfieldExpandMaskfieldOverrideAccessRequestsDefaultsfieldUpdateMaskfieldAppEntitlementUpdateParams

Hide ParametersShow Parameters

AppIDfield

param.Field[string]

Path param: The ID of the app that is associated with the app entitlement.

Entitlementfield

optional

param.Field[IDstringAliasstringAppIDstringAppResourceIDstringAppResourceTypeIDstringCertifyPolicyIDstringComplianceFrameworkValueIDsarrayCreatedAtTimeDefaultValuesAppliedboolDeletedAtTimeDeprovisionerPolicyC1APIPolicyV1ProvisionPolicyDescriptionstringDisplayNamestringDurationGrantstringDurationUnsetanyEmergencyGrantEnabledboolEmergencyGrantPolicyIDstringGrantCountstringGrantPolicyIDstringIsAutomationEnabledboolIsManuallyManagedboolMatchBatonIDstringOverrideAccessRequestsDefaultsboolProvisionerPolicyC1APIPolicyV1ProvisionPolicyPurposeC1APIAppV1AppEntitlementPurposeRevokePolicyIDstringRiskLevelValueIDstringSlugstringSourceConnectorIDsmapSystemBuiltinboolUpdatedAtTimeUserEditedMaskstringC1APIAppV1AppEntitlement]

Body param: The app entitlement represents one permission in a downstream App (SAAS) that can be granted. For example, GitHub Read vs GitHub Write.

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

• durationUnset
• durationGrant

ExpandMaskfield

optional

param.Field[PathsarrayC1APIAppV1AppEntitlementExpandMask]

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

OverrideAccessRequestsDefaultsfield

optional

param.Field[bool]

Body param: Flag to indicate that access request defaults, if any are applied to these entitlements, should be overridden.

UpdateMaskfield

optional

param.Field[string]

Body param:

Returns

AppEntitlementUpdateResponsestruct

The UpdateAppEntitlementResponse 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

[]AppEntitlementUpdateResponseExpanded

List of related objects

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.Update(
    context.TODO(),
    "id",
    conductoronesdk.AppEntitlementUpdateParams{
      AppID: "app_id",
    },
  )
  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"
    }
  ]
}