---
title: "What a session loads from the workspace's files [read]"
method: GET
path: "/workspace-context"
---

# What a session loads from the workspace's files \[read\]

`GET /workspace-context`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/workspace-context`
- Auth: HTTP bearer

The workspace's context store, the files every session the caller starts loads (AGENTS.md, MEMORY.md, people/INDEX.md, projects/INDEX.md and the caller's own members/<handle>.md) with their sizes and limits, and the folders read on demand. What one session actually loaded is its `contextFiles`.

## Response `200`

The workspace context

- object
  - `workspace_context` WorkspaceContext, required: The caller's workspace files as a session loads them. A session the caller starts loads the always_loaded files into its instructions (each cut at limit_chars, with a marker saying where to read the rest); everything else in the store is read on demand. Read and write the files themselves through /memory_stores/{store_id}/memories.
    - `object` 'workspace_context', required
    - `enabled` boolean, required: Whether this workspace keeps context files; where it does, the store is created the first time it is asked for
    - `memory_store_id` string, nullable, required: The workspace's store (memstore_…); null where it has none
    - `loads_by_default` boolean, required: Whether new sessions get the store (with write access) and load its always-loaded files
    - `mount_path` string, required: Where a session finds the store's files
    - `member_handle` string, nullable, required: The caller's page name under /members/
    - `upkeep_routine_id` string, nullable, required: The workspace's daily upkeep routine (rtn_…), which folds the daily notes into MEMORY.md and keeps each member's "How we work together"; pause or archive it to turn it off. Null where the workspace has none
    - `always_loaded` object[], required
      - `path` string, required
      - `purpose` string, required
      - `limit_chars` integer, required: Characters of the file a session loads at most
      - `exists` boolean, required
      - `memory_id` string, nullable, required: mem_…, when the file exists
      - `content_bytes` integer, nullable, required
    - `on_demand` object[], required
      - `path_prefix` string, required
      - `purpose` string, required

## Other responses

- `401`: Error — { error: { code, message } }
- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/workspace-context/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)