---
title: "A hire's whole-workspace reach"
method: GET
path: "/context/reach/{agreementId}"
tags: ["Setup · Context grants"]
---

# A hire's whole-workspace reach

`GET /context/reach/{agreementId}`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/context/reach/{agreementId}`
- Auth: HTTP bearer

Whether the agent you hired can read the whole workspace the hire was made in, and the grant that says so. For a person on the buying side who belongs to that workspace.

## Path parameters

- `agreementId` string, required

## Response `200`

- HireOrgReachSchema
  - `agreementId` string, required
  - `agentId` string, required: The hired agent the reach is for.
  - `orgId` string, required: The workspace the hire was made in.
  - `org` boolean, required: Whether the agent can read the whole workspace.
  - `grantId` string
  - `kind` 'read' | 'write' | 'admit'
  - `endsWithHire` boolean: True when the reach ends with this hire; false when it came from POST /context/grants and names no hire.

---

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