# GET /memory

**Resource:** [Agent Memory](./memory.md)  
**Scopes:** `memory:read`  
**Write operation:** no

List agent memories for this workspace. Filter by subject_type, subject_id, kind, agent_registry_id, visibility, tag, linked entity, or time. Cursor-paginated (newest first).

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `subject_type` | query | string | no | Filter by subject type: "contact", "opportunity", "company", "self", "campaign", or any agent-defined value. |
| `subject_id` | query | uuid | no | Filter by subject id (use with subject_type). |
| `kind` | query | string | no | Filter by memory kind: "pitch", "objection", "preference", "observation", "next_steps", "fact", or any agent-defined value. |
| `agent_registry_id` | query | uuid | no | Filter by owning agent. Omit to see all memories visible in the workspace. |
| `visibility` | query | string | no | Filter by visibility: "private" or "shared". |
| `tag` | query | string | no | Tag filter (any-of). Repeat param for multiple tags: ?tag=objection:pricing&tag=competitor:Twilio. |
| `linked_entity_type` | query | string | no | Find memories linked to entities of this type. Must be combined with linked_entity_id. |
| `linked_entity_id` | query | string | no | Find memories linked to this entity id (combine with linked_entity_type). |
| `since` | query | string | no | ISO 8601 timestamp -- only memories created after this time. |
| `limit` | query | number | no | Items per page (default 25, max 100). |
| `after` | query | string | no | Cursor: return items after this id. |

## Response example

```json
{
  "data": [
    {
      "id": "e836adbb-1d1d-4a96-9913-9841ae905fe8",
      "company_id": "ebeff86e-7b09-4e49-96db-f711d69d2d57",
      "agent_registry_id": "a1b2c3d4-0000-0000-0000-000000000001",
      "visibility": "private",
      "subject_type": "contact",
      "subject_id": "c1d2e3f4-0000-0000-0000-000000000001",
      "kind": "pitch",
      "key": "voice-agents-intro",
      "content": "Pitched the Voice Agents article to Wayne. He seemed interested in the inbound call routing feature but asked about pricing.",
      "metadata": {
        "feature_pitched": "voice_agents",
        "pitch_angle": "inbound routing",
        "next_angles_to_try": [
          "pricing-tier",
          "roi-case-study"
        ]
      },
      "linked_entities": [
        {
          "type": "opportunity",
          "id": "opp-uuid"
        }
      ],
      "tags": [
        "feature:voice_agents",
        "sentiment:interested",
        "objection:pricing"
      ],
      "confidence": 1,
      "source_kind": "email_send",
      "source_id": "email-log-uuid",
      "parent_memory_id": null,
      "expires_at": null,
      "created_at": "2026-05-19T05:14:08.487894+00:00",
      "updated_at": "2026-05-19T05:14:13.156261+00:00"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "url": "https://app.trustpager.com/auto/agent-hub"
  }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`