Update project

PATCH

/api/v1/projects/{id}

curl --request PATCH \
  --url https://api.deploybase.eu/api/v1/api/v1/projects/example \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "auto_deploy_enabled": true, "build_command": "example", "default_branch": "example", "framework": "nextjs", "git_provider": "github", "git_repo_url": "example", "git_token": "example", "mr_previews_enabled": true, "name": "example", "output_dir": "example", "package_manager": "npm", "preview_branch_exclude": [ "example" ], "preview_branch_include": [ "example" ], "preview_branch_mode": "example", "root_directory": "example", "skip_git_validation": true, "subdomain": "example" }'

Updates an existing project (partial update)

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Project ID (UUID)

Request Body

Project updates

Media type application/json

object

auto_deploy_enabled

boolean

build_command

string

<= 500 characters

default_branch

string

<= 255 characters

framework

string

Allowed values: nextjs sveltekit astro hugo vite gatsby jekyll static-html other

git_provider

string

Allowed values: github gitlab bitbucket codeberg

git_repo_url

string

git_token

string

<= 500 characters

mr_previews_enabled

Whether merge/pull request events build previews. Independent of the branch policy.

boolean

name

string

>= 1 characters <= 255 characters

output_dir

string

<= 255 characters

package_manager

string

Allowed values: npm pnpm yarn bun

preview_branch_exclude

Replaces the exclude list, evaluated before the include list. Send [] to clear it.

Array<string>

preview_branch_include

Replaces the include list. Send [] to clear it. Maximum 32 patterns.

Array<string>

preview_branch_mode

Which webhook pushes auto-build a preview: “all”, “none” (only the default branch) or “custom”. Each policy field is independently optional; an omitted one keeps its stored value. The default branch always builds.

string

root_directory

string

<= 255 characters

skip_git_validation

boolean

subdomain

string

>= 3 characters <= 63 characters

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

auto_deploy_enabled

Auto-deploy (GitHub webhook) fields

boolean

build_command

string

bunny_edge_rule_guid

string

bunny_not_found_edge_rule_guid

string

bunny_pull_zone_id

integer

created_at

string

default_branch

string

framework

string

Allowed values: nextjs sveltekit astro hugo vite gatsby jekyll static-html other

git_connection_id

Optional FK to team_git_connections; nil = manual PAT

string

git_provider

string

git_repo_url

string

id

string

live_deployment_id

string

mr_previews_enabled

MRPreviewsEnabled governs merge/pull-request previews on its own: the branch policy above never applies to an MR event.

boolean

name

string

output_dir

string

package_manager

PackageManager overrides the Node package manager used at build time. nil = auto-detect (lockfile / packageManager field); set = user override.

string

Allowed values: npm pnpm yarn bun

preview_branch_exclude

Array<string>

preview_branch_include

Array<string>

preview_branch_mode

Preview branch policy (DEP-287). Decides which webhook pushes auto-build a preview; see ShouldAutoBuildBranch in preview_branch_policy.go. Nothing here touches manual/API/MCP/ZIP deploys, and the default branch is never filtered.

string

Allowed values: all none custom

production_url

string

root_directory

string

slug

string

status

string

Allowed values: active deleting

subdomain

Production URL fields

string

team_id

string

updated_at

string

Example

{
  "data": {
    "framework": "nextjs",
    "package_manager": "npm",
    "preview_branch_mode": "all",
    "status": "active"
  }
}

400

Bad Request

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

404

Not Found

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}