Get a project

Returns a single project by ID.

GET/projects/{id}

Authorization

Requires: BearerAuth

Path parameters

idstring (uuid)pathrequired

Project UUID

Response

200 — Project found

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 or you don't have access

errorstringrequired

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

messagestringrequired

Human-readable error description

Get a project

curl --request GET \
  --url 'https://api.codivdocs.com/v1/projects/{id}' \
  --header 'Authorization: Bearer <token>'

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