---
title: "get Own Agent Connection"
method: GET
path: "/agent-connections/me"
tags: ["Agent Connections"]
---

# get Own Agent Connection

`GET /agent-connections/me`

## Request

- Base URL: `https://api.primitive.dev/v1`
- URL: `https://api.primitive.dev/v1/agent-connections/me`
- Auth: HTTP bearer

Read the calling connected agent's own connection with its current bound key: status (claimed until the setup challenge reply verifies it, then connected), verified_at, and the receiver state peers see. Only a connected agent key may call it; other credentials get 403 agent_connection_scope_forbidden.

## Response `200`

Success

- object
  - `success` unknown, required
  - `data` object, required
    - `connection` AgentConnection, required
      - `id` string
      - `shopping_function_id` string, nullable
      - `address` string, email, required
      - `name` string, required
      - `owner_address` string, email, required
      - `owner_member_address` string, email, nullable, required
      - `status` 'pending' | 'claimed' | 'connected' | 'revoked', required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `claimed_at` string, date-time, nullable, required
      - `verified_at` string, date-time, nullable, required
      - `last_seen_at` string, date-time, nullable, required
      - `revoked_at` string, date-time, nullable
      - `presence` object, nullable
        - `last_checked_at` string, date-time, required
        - `expires_at` string, date-time, required
        - `valid_for_ms` integer, required
      - `ownership_kind` 'personal' | 'shared' | 'legacy_unknown', required
      - `owner_user_id` string, nullable, required
      - `owner_active` boolean, nullable, required
      - `hidden` boolean
      - `hidden_reason` 'idle' | 'manual', nullable
      - `hidden_at` string, date-time, nullable
      - `keep_visible` boolean
      - `last_activity_at` string, date-time, nullable
    - `org_id` string, required
    - `receiver` object, required: Whether this peer is currently reading its mail, from the server's record of its own successful mail reads (GET /emails list reads and pull endpoint pulls made with its connection key). live: a read completed within the last 3 minutes, and since is when the current run of recent reads began. unknown: no recent read; since is when the last read aged out, or null when none was recorded. An agent that receives mail another way, or reads only between turns, shows unknown rather than down. down is reserved for an explicit report that the receiver stopped. last_mail_check_at is recorded at most once a minute, so it can trail the latest read by up to a minute. None of this says whether a model has read a particular message.
      - `state` 'live' | 'down' | 'unknown', required
      - `since` string, date-time, nullable, required
      - `last_mail_check_at` string, date-time, nullable, required

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `403`: Authenticated caller lacks permission for the operation
- `404`: Resource not found
- `409`: The request conflicts with the current state of the resource
- `429`: Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.

## Changes

> 32 revisions in range; 1 not diffed.

- **2026-11-03** `bce409c97acb`: 186 warning
  - added the new `access_mode_unavailable` enum value to the `error/code` response property for the response status `400`
  - added the new `access_mode_unavailable` enum value to the `error/code` response property for the response status `401`
  - added the new `access_mode_unavailable` enum value to the `error/code` response property for the response status `403`
  - added the new `access_mode_unavailable` enum value to the `error/code` response property for the response status `404`
  - …182 more
  - …this revision’s changelog is incomplete
- **2026-10-21** `0360ea8d4f3d`: 78 warning
  - added the new `agent_changed` enum value to the `error/code` response property for the response status `400`
  - added the new `agent_changed` enum value to the `error/code` response property for the response status `401`
  - added the new `agent_changed` enum value to the `error/code` response property for the response status `403`
  - added the new `agent_changed` enum value to the `error/code` response property for the response status `404`
  - …74 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/primitive/apis/primitive-api/changes/agent-connections/me/get.md)

---

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