Skip to content

Get project

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

Returns details of a specific project

id
required
string

Project ID (UUID)

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

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

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