---
title: "Get project tree"
method: GET
path: "/api/v2/programmatic/projects/{projectId}/tree"
tags: ["Projects"]
---

# Get project tree

`GET /api/v2/programmatic/projects/{projectId}/tree`

Auto-acquires a Design Engine instance, then returns a flat tree of project objects.

## Path parameters

- `projectId` string, required

## Query parameters

- `branch` string

## Response `200`

Project tree.

- ProjectTreeEnvelope
  - `success` boolean, required
  - `data` ProjectTree, required
    - `objectCount` integer
    - `tree` TreeNode[], required
      - `id` string, required
      - `name` string, required
      - `type` string, required
      - `parent` string, required
      - `childrenCount` integer

## Other responses

- `401` — Missing, invalid, expired, or inactive API key.
- `403` — Caller is authenticated but not authorized.
- `404` — Project does not exist or is hidden from the caller.
- `429` — API key request rate exceeded.
- `500` — Unexpected server error.
- `503` — Project acquisition unavailable. Common error codes include `PROJECT_NOT_READY`, `SERVICE_UNAVAILABLE`, and `SERVER_NOT_AVAILABLE`.

---

[API](https://skmtc.dev/davinci-app/apis/davinci-public-api.md) · [All operations](https://skmtc.dev/davinci-app/apis/davinci-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/davinci-app/davinci-public-api/revisions/d6e554d88cf6/schema)