---
title: "List user's projects"
method: GET
path: "/api/cli/projects"
tags: ["CLI"]
---

# List user's projects

`GET /api/cli/projects`

## Request

- Base URL: `https://intentdocs.com`
- URL: `https://intentdocs.com/api/cli/projects`
- Auth: OAuth 2 (authorization code, authorization URL `https://intentdocs.com/api/oauth/authorize`, token URL `https://intentdocs.com/api/oauth/token`, scopes: `read:projects`)

Retrieve all projects owned by the authenticated user. Used by the CLI to discover available projects for map operations.

## Response `200`

List of projects

- object
  - `projects` object[], required
    - `id` string: Unique project identifier
    - `name` string: Project title
    - `description` string: Project problem statement

## Other responses

- `401`: Invalid or missing authentication token
- `500`: Failed to fetch projects

---

[API](https://skmtc.dev/intentdocs/apis/intentdocs-api.md) · [All operations](https://skmtc.dev/intentdocs/apis/intentdocs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/intentdocs/apis/intentdocs-api/revisions/28abdea021d0?raw)