Create

Create

client.Apps.New(ctx, body) (*AppC1APIAppV1AppAppNewResponse, error)

post/api/v1/apps

Create a new manual app without a connector.

Parameters

bodyDisplayNamefieldCertifyPolicyIDfieldDescriptionfieldGrantPolicyIDfieldIdentityMatchingfieldMonthlyCostUsdfieldOwnersfieldRevokePolicyIDfieldStrictAccessEntitlementProvisioningfieldAppNewParams

Hide ParametersShow Parameters

DisplayNamefield

param.Field[string]

Creates the app with this display name.

CertifyPolicyIDfield

optional

param.Field[string]

Creates the app with this certify policy.

Descriptionfield

optional

param.Field[string]

Creates the app with this description.

GrantPolicyIDfield

optional

param.Field[string]

Creates the app with this grant policy.

IdentityMatchingfield

optional

param.Field[AppNewParamsIdentityMatching]

Define the app user identity matching strategy for this app.

Hide ParametersShow Parameters

AppNewParamsIdentityMatchingAppUserIdentityMatchingUnspecifiedconst

AppNewParamsIdentityMatching

"APP_USER_IDENTITY_MATCHING_UNSPECIFIED"

AppNewParamsIdentityMatchingAppUserIdentityMatchingStrictconst

AppNewParamsIdentityMatching

"APP_USER_IDENTITY_MATCHING_STRICT"

AppNewParamsIdentityMatchingAppUserIdentityMatchingDisplayNameconst

AppNewParamsIdentityMatching

"APP_USER_IDENTITY_MATCHING_DISPLAY_NAME"

MonthlyCostUsdfield

optional

param.Field[int64]

Creates the app with this monthly cost per seat.

formatint32

Ownersfield

optional

param.Field[[]string]

Creates the app with this array of owners.

RevokePolicyIDfield

optional

param.Field[string]

Creates the app with this revoke policy.

StrictAccessEntitlementProvisioningfield

optional

param.Field[bool]

This flag enforces a provisioning mode where the access entitlement is always included in the provisioning flow, if the app user doesn't exist

Returns

AppNewResponsestruct

Returns the new app's values.

Hide ParametersShow Parameters

AppIDstringAppAccountIDstringAppAccountNamestringAppOwnersarrayCertifyPolicyIDstringConnectorVersionint64CreatedAtTimeDefaultRequestCatalogIDstringDeletedAtTimeDescriptionstringDisplayNamestringFieldMaskstringGrantPolicyIDstringIconURLstringIdentityMatchingC1APIAppV1AppIdentityMatchingInstructionsstringIsDirectoryboolIsManuallyManagedboolLogoUristringMonthlyCostUsdint64ParentAppIDstringRevokePolicyIDstringStrictAccessEntitlementProvisioningboolUpdatedAtTimeUserCountstringC1APIAppV1App

optional

The App object provides all of the details for an app, as well as some configuration.

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"),
  )
  app, err := client.Apps.New(context.TODO(), conductoronesdk.AppNewParams{
    DisplayName: "displayName",
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", app.App)
}

200 Example

{
  "app": {
    "certifyPolicyId": "certifyPolicyId",
    "connectorVersion": 0,
    "defaultRequestCatalogId": "defaultRequestCatalogId",
    "description": "description",
    "displayName": "displayName",
    "grantPolicyId": "grantPolicyId",
    "iconUrl": "iconUrl",
    "identityMatching": "APP_USER_IDENTITY_MATCHING_UNSPECIFIED",
    "instructions": "instructions",
    "isManuallyManaged": true,
    "monthlyCostUsd": 0,
    "revokePolicyId": "revokePolicyId",
    "strictAccessEntitlementProvisioning": true
  }
}