Create database branch

Creates a new branch from the specified parent branch (or default ‘main’ branch). Branches provide instant point-in-time clones of your database for isolated development, staging, testing, or feature work. Perfect for testing schema changes, running migrations safely, or creating ephemeral preview environments.

POST /database/v1/projects/{id}/branches

cURL

cURL

curl -X POST "https://api.case.dev/database/v1/projects/%3Cstring%3E/branches" \ -H "Authorization: Bearer $CASEDEV_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "<string>" }'

201

{
  "id": "branch_staging_456",
  "name": "staging",
  "parentBranchId": "branch_main_123",
  "isDefault": false,
  "status": "active",
  "createdAt": "2025-01-15T10:30:00Z"
}

Authorizations

Authorization · string · header · required

API key starting with sk_case_

Path Parameters

id · string · required

Database project ID

Body

application/json

name · string · required

Branch name (letters, numbers, hyphens, underscores only)

Pattern: ^[a-zA-Z0-9_-]+$

parentBranchId · string

Parent branch ID to clone from (defaults to main branch)

Response

201

application/json

Branch created successfully

id · string · required

Branch ID

name · string · required

Branch name

parentBranchId · string | null · required

Parent branch ID

isDefault · boolean · required

Whether this is the default branch (always false for new branches)

status · string · required

Branch status

createdAt · string<date-time> · required

Branch creation timestamp