> Documentation index for AI agents: https://docs.pagerduty.com/llms.txt

# List SRE Agent memories

`GET https://api.pagerduty.com/sre_agent/memories`

Search SRE Agent memories for the account.

Memories are knowledge learned by the SRE Agent, including service runbooks, service profiles,
incident playbooks, and incident summaries. Filter by service ID, incident ID, or memory type to retrieve
relevant memories.

Scoped OAuth requires: `incident.read`

## Authorization

- **api_key** (apiKey) — `Authorization` header. The API Key with format `Token token=<API_KEY>`

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | integer |  | The number of results to return per page. Default: `20 - incident_summary`. Minimum: 1. Maximum: 100. |
| `service_id` | string |  | Filter memories by service ID. |
| `incident_id` | string |  | Filter memories by incident ID. |
| `type` | string |  | Filter memories by type. One of: `runbook`, `service_profile`, `incident_playbook`. |

## Header parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `Accept` | string | yes | The `Accept` header is used as a versioning header. Default: `application/vnd.pagerduty+json;version=2`. |

## Response 200

An array of SRE Agent memories.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `memories` | array of object | yes |  |
| `memories[].id` | string |  | The unique identifier for this memory. Read-only. |
| `memories[].content` | string | yes | The content of the SRE memory. |
| `memories[].attributes` | object |  | Additional attributes associated with this memory. |
| `memories[].attributes.account_id` | string |  | The ID of the account this memory is associated with. |
| `memories[].attributes.service_id` | string |  | The ID of the service this memory is associated with. |
| `memories[].attributes.incident_id` | string |  | The ID of the incident this memory is associated with. |
| `memories[].attributes.type` | string |  | The type of memory. One of: `runbook`, `service_profile`, `incident_playbook`, `incident_summary`. |
| `memories[].created_at` | string (date-time) |  | The date and time the memory was created. Read-only. |
| `memories[].updated_at` | string (date-time) |  | The date and time the memory was last updated. Read-only. |

Example: Response Example

```json
{
  "memories": [
    {
      "attributes": {
        "account_id": "PLHJ8WE",
        "service_id": "PJYY37U",
        "type": "service_profile"
      },
      "content": "The Payment Processing Service handles all transaction processing with a 99.9% SLA target. Primary dependencies include Redis cache and PostgreSQL database.",
      "created_at": "2026-02-23T19:53:19.268Z",
      "id": "PLHJ8WE",
      "updated_at": "2026-02-23T19:53:19.268Z"
    },
    {
      "attributes": {
        "account_id": "PLHJ8WE",
        "service_id": "PJYY37U",
        "type": "runbook"
      },
      "content": "To restart the Payment Processing Service, first drain traffic from the load balancer, then run 'systemctl restart payment-service', and verify health checks pass before restoring traffic.",
      "created_at": "2026-02-24T17:15:42.123Z",
      "id": "PM4QR2T",
      "updated_at": "2026-02-24T17:15:42.123Z"
    },
    {
      "attributes": {
        "account_id": "PLHJ8WE",
        "incident_id": "PX9LMN2",
        "service_id": "PJYY37U",
        "type": "incident_playbook"
      },
      "content": "For payment timeout incidents, check Redis cache connection pool first, then verify database query performance. Restart cache service if connection pool is exhausted.",
      "created_at": "2026-02-25T22:22:10.543Z",
      "id": "PQRS123",
      "updated_at": "2026-02-25T22:22:10.543Z"
    },
    {
      "attributes": {
        "account_id": "PLHJ8WE",
        "incident_id": "PX9LMN2",
        "service_id": "PJYY37U",
        "type": "incident_summary"
      },
      "content": "Payment service experienced timeout errors due to exhausted Redis connection pool. Resolved by restarting cache service and increasing pool size from 50 to 100 connections.",
      "created_at": "2026-02-26T00:45:30.123Z",
      "id": "PXYZ789",
      "updated_at": "2026-02-26T00:45:30.123Z"
    }
  ],
  "limit": 20
}
```

## Response 401

Caller did not supply credentials or did not provide the correct credentials.
If you are using an API key, it may be invalid or your Authorization header may be malformed.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Response 403

Caller is not authorized to view the requested resource.
While your authentication is valid, the authenticated user or token does not have permission to perform this action.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Response 429

Too many requests have been made, the rate limit has been reached.

### `application/json`

| Field | Type | Required | Description |
|---|---|---|---|
| `error` | object |  |  |
| `error.code` | integer |  | Read-only. |
| `error.message` | string |  | Error message string. Read-only. |
| `error.errors` | array of string |  | Read-only. |

## Developer Agreement

Your access to and use of the PagerDuty Developer Services is governed by the [PagerDuty Developer Agreement](https://docs.pagerduty.com/developer/pagerduty-developer-agreement).