Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

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

Initial user owners for ordinary API creation. Requests with match_baton_ref must leave this empty; Terraform manages owners with conductorone_app_owner_user.

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

CreateAppResponse contains the newly created application.