API access

Programmatic access to Tree projects and data through a REST API.

API access provides programmatic access to Tree's data through a REST API. Developers can read and write projects, nodes, edges, and metadata from external scripts, services, or custom integrations. API access is a Paid feature available on Paid and Team tiers.

What the API supports

The API supports:

  • Reading projects: list workspaces, list projects, retrieve project structure
  • Reading nodes and edges: retrieve individual nodes or edges, list with filters
  • Writing nodes and edges: create, update, and delete nodes and edges
  • Triggering state changes: mark nodes complete, start in-progress, reset states
  • Managing assignments (Team): assign and reassign nodes
  • Querying activity (Team): retrieve activity feed entries

The full API surface mirrors what the Tree UI can do. Operations available in the app are available through the API.

Authentication

API requests authenticate via:

  • Personal access tokens for individual users
  • Workspace tokens for service-level integrations
  • OAuth for third-party apps that need user-delegated access

Tokens are scoped to specific workspaces and can be revoked at any time.

Rate limits

API requests are rate-limited per token:

  • Read operations have a generous limit suitable for typical integration use
  • Write operations have a tighter limit to prevent accidental graph corruption
  • Burst allowances accommodate short spikes in request volume

The current limits are documented in the API reference.

Common uses

API access is useful for:

  • Custom integrations: connecting Tree to internal tools or proprietary systems
  • Bulk operations: scripted import, export, or restructuring at scale
  • Reporting and analytics: pulling data into external dashboards or BI tools
  • AI-driven workflows: programmatic graph manipulation from LLM-based scripts

For event-driven integrations, Webhooks are usually a better fit than polling the API.

Tier availability

API access is a Paid feature, available on Paid and Team. Free does not include API access.

LAST UPDATED · 2026-05-12