List projects

GET

/api/v1/projects

curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/projects \
  --header 'Authorization: <Authorization>'

Returns a paginated list of projects for the authenticated team

Authorizations

• BearerAuth

Parameters

Query Parameters

page

integer

Page number (default: 1)

page_size

integer

Items per page (default: 20, max: 100)

search

string

Search by project name

sort_by

string

Sort order: activity (default) or name

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

page

integer

page_size

integer

projects

Array<object>

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

latest_deploy_status

string

latest_deployed_at

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

total

integer

total_pages

integer

Example

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

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"
  }
}