[Experimental]

Create service

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

Creates a new service under the specified project. The projectId is required in the request body. The service is placed in the given region, or the project's default region if omitted (falling back to us-east-1). Returns 409 Conflict when a service already occupies the slot on the resolved branch, either by name or by logicalId; the body includes the existing service'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/services

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/services
  • 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

Service created.

Changes

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