---
title: "List story maps for a project"
method: GET
path: "/api/cli/projects/{projectId}/maps"
tags: ["CLI"]
---

# List story maps for a project

`GET /api/cli/projects/{projectId}/maps`

## Request

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

Retrieve all story maps for a specific project. Sync calls take the map id in the path and authenticate with the same CLI bearer.

## Path parameters

- `projectId` string, required

## Response `200`

List of story maps

- object
  - `maps` object[]
    - `id` string
    - `title` string
    - `status` string
  - `appUrl` string

## Other responses

- `401`: Invalid or missing authentication token
- `404`: Project not found
- `500`: Failed to fetch maps

---

[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)