Create an app within a project. The app is created with default production and preview environments.

Set exactly one source. Use git to create a GitHub-sourced app and connect its repository. Use oci to create an app from a prebuilt OCI image.

The slug you provide is the stable, caller-defined handle used to reference this app. It must be unique within the project.

Important: The slug cannot collide with an existing app in the same project. A duplicate slug returns a 409 conflict.

Required Permissions

Your root key must have one of the following permissions:

• project.*.create_app (to create apps in any project)
• project.<project_id>.create_app (to create apps in a specific project)

{
  "project": "proj_1234abcd",
  "name": "Payments API",
  "slug": "proj_1234abcd",
  "git": {
    "repository": "unkeyed/unkey",
    "defaultBranch": "main"
  },
  "oci": {
    "image": "ghcr.io/acme/api:v1.2.3"
  }
}

{
  "meta": {
    "requestId": "req_123"
  },
  "data": {
    "appId": "app_1234abcd"
  }
}