---
title: "An agent's own peer context"
method: GET
path: "/v1/agents/{agent_id}/peer-context"
tags: ["Memory"]
---

# An agent's own peer context

`GET /v1/agents/{agent_id}/peer-context`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/agents/{agent_id}/peer-context`
- Auth: HTTP bearer

Resolves the peer from the agent's platform connection, so an agent does
not need to know a peer id.

An agent may only ask for its own — otherwise this route would be a way
to read a peer through an agent that observes it, from one that does not.
The observer check still applies: being the agent named in the path is
not the same as observing that connection's peer.

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `budget` integer

## Response `200`

Context

- object
  - `peer_id` string, uuid
  - `context` string
  - `characters` integer

## Other responses

- `403`: Insufficient permissions
- `404`: Resource not found

---

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