---
title: "List Sharing Requests"
method: GET
path: "/memories/sharing/requests"
tags: ["Memories"]
---

# List Sharing Requests

`GET /memories/sharing/requests`

## Request

- Base URL: `https://api.hyperspell.com`
- URL: `https://api.hyperspell.com/memories/sharing/requests`
- Auth: HTTP bearer

List your pending sharing requests, newest first.

By default, list agent activity. Use kind=all to include other memories.
Use search to reach older requests. Deciding a request removes it from this queue;
when has_more is true, list again after deciding the returned requests.

## Query parameters

- `q` string, nullable
- `kind` 'agent_activity' | 'all'
- `limit` integer

## Headers

- `X-As-User` string, nullable: Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token

## Response `200`

Successful Response

- SharingRequests
  - `requests` SharingRequest[], required
    - `source` string, required
    - `resource_id` string, required
    - `title` string, nullable, required
    - `kind` string, nullable, required
    - `preview` string, nullable, required
    - `document_date` string, date-time, nullable, required
    - `audiences` string[], required
  - `has_more` boolean, required
  - `query` string, nullable, required
  - `kind` 'agent_activity' | 'all', required

## Other responses

- `422`: Validation Error

## Changes

> 43 revisions in range; 2 not diffed.

- **2026-10-21** `8bfe4e0b0ee1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hyperspell/apis/hyperspell-api/changes/memories/sharing/requests/get.md)

---

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