[Experimental]

Create app

⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️

Deprecated: use POST /v1/services instead.

Creates a new app under the specified project. The projectId is required in the request body. The app is placed in the given region, or the project's default region if omitted (falling back to us-east-1). Returns 409 Conflict when an app already occupies the slot on the resolved branch, either by name or by logicalId; the body includes the existing app's id, name, branch, and logical id, and conflict says which attribute clashed. The name is checked first. logicalId cannot be combined with branchGitName; pass branchId instead.

post/v1/apps

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/apps
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://auth.prisma.io/authorize, token URL https://auth.prisma.io/token, scopes: workspace:admin, offline_access)
    • HTTP bearer

Request body

displayNamestring required
regionId'us-east-1' | 'us-west-1' | 'eu-west-3' | 'eu-central-1' | 'ap-northeast-1' | 'ap-southeast-1'
branchIdstring nullable
branchGitNamestring nullable
projectIdstring required
logicalIdstring

Declared identity of the resource, unique within its branch. Set by the tool that declares the resource.

Response

App created.

Changes

No recorded changes to this operation across all 1 revision of this API.