Update a project

Update one or more fields of a project. Only the supplied fields are modified.

PATCH/projects/{id}

Authorization

Requires: BearerAuth

Path parameters

idstring (uuid)pathrequired

Request body

namestringbody

custom_domainstringbody

github_branchstringbody

Response

200 — Project updated

idstring (uuid)required

Unique project identifier

namestringrequired

Human-readable project name

slugstringrequired

URL slug — used as the subdomain `{slug}.codivdocs.com`

statusenum (pending, building, active...)required

Current project status

created_atstring (date-time)required

Project creation timestamp

github_repostring

Connected GitHub repo in `owner/name` format

custom_domainstring

Custom domain (e.g. `docs.acme.com`) if configured

github_branchstring

Branch synced for deployments

last_deploy_atstring (date-time)

Timestamp of the most recent successful deployment

404 — Project not found

errorstringrequired

Machine-readable error code (e.g. `invalid_request`, `unauthorized`, `not_found`)

messagestringrequired

Human-readable error description

Update a project

curl --request PATCH \
  --url 'https://api.codivdocs.com/v1/projects/{id}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "custom_domain": "<string>",
  "github_branch": "<string>"
}'

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "<string>",
  "slug": "<string>",
  "status": "pending",
  "created_at": "2026-04-13T03:19:49.379Z",
  "github_repo": "<string>",
  "custom_domain": "<string>",
  "github_branch": "main",
  "last_deploy_at": "2026-04-13T03:19:49.379Z"
}