---
title: "list Agent Workspace Resources"
method: GET
path: "/api/v1/workspaces/{workspaceId}/resources"
tags: ["Workspaces"]
---

# list Agent Workspace Resources

`GET /api/v1/workspaces/{workspaceId}/resources`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/workspaces/{workspaceId}/resources`
- Auth: HTTP bearer

Account-scoped HTTP v1 agent operation within the credential's fixed workspace and current owner/source authority. Workspace selection never changes browser preferences. Policies cannot be activated by an agent. Insights require a 20-observation cohort; delivery history omits titles and app paths.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `section` 'reviews' | 'forms' | 'research' | 'brain' | 'sources'
- `q` string
- `filters` string: JSON object of string arrays using this collection's browser filter vocabulary.
- `sort` string
- `sourceId` string
- `cursor` string
- `limit` 25

## Headers

- `X-Commentary-Workspace-Id` string
- `X-Correlation-Id` string

## Response `200`

Authorized response. Reads never mark recipient state or apply policy effects. Proposals are disabled and pending human approval.

- object
  - `data` object, required

## Other responses

- `400`: Invalid input.
- `401`: A valid bearer token is required.
- `403`: The grant, workspace, membership, scope, feature, or source authority does not authorize this action.
- `404`: Authorized resource or item was not found.
- `409`: The version, retry key, or proposal limit conflicts.
- `500`: The request could not be completed.
- `503`: Source access or projection is temporarily unavailable.

---

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