---
title: "List workspace guidance (context) files"
method: GET
path: "/v1/workspaces/{workspaceId}/context"
tags: ["Workspaces"]
---

# List workspace guidance (context) files

`GET /v1/workspaces/{workspaceId}/context`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/context`
- Auth: HTTP bearer

Any member. Markdown house rules an agent reads when working in the workspace.

## Response `200`

Files (unpaginated, max 100)

- object
  - `entry` string: File an agent reads first (default `index.md`).
  - `files` object[]
    - `name` string
    - `size` integer
    - `is_entry` boolean
    - `updated_by` string, nullable
    - `updated_at` string, date-time

## Other responses

- `403`: Access denied

## Changes

- **2026-10-13** `ed6fa61bd690`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/context/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)