---
title: "List structured change requests across the workspace for dashboard re-entry or agent discovery. API-key reads see consumable rows by default and stamp consumption only for those; unaccepted agent proposals are never handed to a different key."
method: GET
path: "/api/v1/change-requests"
tags: ["change requests"]
---

# List structured change requests across the workspace for dashboard re-entry or agent discovery. API-key reads see consumable rows by default and stamp consumption only for those; unaccepted agent proposals are never handed to a different key.

`GET /api/v1/change-requests`

This is the discovery projection used by Workspace/Product Home and by list_intent_change_requests when intentId is omitted. Session reads never count as repository-agent consumption.

## Query parameters

- `include` string
- `status` string

## Response `200`

OK — returns workspace-scoped { changeRequests, count }

- object

## Other responses

- `400` — Invalid status filter
- `401` — Missing or invalid API key/session
- `403` — Lacks read scope
- `500` — DB error, or API-key consumption could not be recorded

## Changes

- **2026-09-04** `35441fda7ae7` — 1 info
  - added the new optional `query` request parameter `include`
- **2026-09-01** `a660c0d36148` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pathmode/apis/pathmode-api/changes/api/v1/change-requests/get.md)

---

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