v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-224341,4072.0 MB

App

Create

Create a new manual app without a connector.

post/api/v1/apps

Request body

annotationsobject

Bounded key/value metadata bag for IaC marking and customer tags. See .rfcs/object-annotations.md §2. Limits: ≤16 entries; keys 1–128 chars matching ^[A-Za-z][A-Za-z0-9._/-]{0,127}$; values 0–256 chars matching URL-safe ASCII; total serialized ≤4096 bytes. Keys starting with c1/ are reserved for server-managed use and rejected on write.

Well-known keys: managed_by, iac_workspace, iac_resource_address, iac_tool_version.

certifyPolicyIdstring

Creates the app with this certify policy.

descriptionstring

Creates the app with this description.

displayNamestring required

Creates the app with this display name.

grantPolicyIdstring

Creates the app with this grant policy.

identityMatching'APP_USER_IDENTITY_MATCHING_UNSPECIFIED' | 'APP_USER_IDENTITY_MATCHING_STRICT' | 'APP_USER_IDENTITY_MATCHING_DISPLAY_NAME' | 'APP_USER_IDENTITY_MATCHING_CUSTOM'

Define the app user identity matching strategy for this app.

instructionsstring

Instructions shown to users in the access request form when requesting access for this app.

monthlyCostUsdinteger

Creates the app with this monthly cost per seat.

ownersstring[] nullable

Creates the app with this array of user owners.

revokePolicyIdstring

Creates the app with this revoke policy.

strictAccessEntitlementProvisioningboolean

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

Response

Returns the new app's values.