---
title: "Get agent workspace context"
method: GET
path: "/v1/agent/context"
tags: ["Agent"]
---

# Get agent workspace context

`GET /v1/agent/context`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/agent/context`
- Auth: HTTP bearer

Returns the comprehensive workspace overview the embedded agent uses to ground its
reasoning: organisation name, document and pipeline counts, document types, schemas
with field counts, active extraction runs, recent activity feed, and field-registry
summary by tier.

## Response `200`

Workspace context summary.

- object
  - `organizationName` string, nullable
  - `documents` object
    - `total` integer
    - `completedThisWeek` integer
    - `completedLast24h` integer
    - `processing` integer
  - `documentTypes` object[]
    - `id` string
    - `name` string
    - `documentCount` integer
  - `schemas` object[]
    - `id` string
    - `name` string
    - `fieldCount` integer
    - `version` integer
  - `activeRuns` object[]
    - `id` string
    - `name` string, nullable
    - `status` string
    - `documentCount` integer
  - `fieldRegistry` object
    - `totalFields` integer
    - `tier1` integer
    - `tier2` integer
    - `tier3` integer
  - `recentActivity` object[]
    - `type` string
    - `message` string
    - `timestamp` string, date-time
    - `actor` string, nullable

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

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