Create Access Request

Initiate a request for access to a specific user’s memory store using their unique Memory Key. The user must approve this request via the Memoram dashboard.

POST /access-requests

Create Access Request

cURL

curl --request POST \
  --url https://api.memoram.app/api/v1/access-requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memoryKey": "user_provided_mem_key",
  "reason": "DemoBot would like to access your ai memories"
}
'

201

{
  "id": "<string>",
  "reason": "<string>",
  "memoryKey": "<string>",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "aiConnectorId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Initiate a request for access to a specific user’s memory store using their unique Memory Key. The user must approve this request via the Memoram dashboard before you can retrieve their credentials.

Authorization

Requires Bearer token authentication using your Developer JWT.

Authorizations

Authorization · string · header · required

JWT token obtained via /auth/token endpoint.

Body

application/json

memoryKey · string · required

The user's unique Memory Key obtained from the user directly.

reason · string · required

A brief description of why your application needs access to the user's memories. This is shown to the user.

Maximum string length: 255

Response

201

application/json

Access request created successfully. Status will be 'pending'.

id · string

Unique ID of the access request.

status · enum<string>

The current status of the access request.

Available options: pending, approved, rejected, revoked

reason · string

The reason provided when creating the request.

memoryKey · string

The user's memory key associated with this request.

user_id · string<uuid>

The unique ID of the user this request pertains to (available once linked).

aiConnectorId · string

The ID of the AI Connector (developer application) that made the request.

createdAt · string<date-time>

Timestamp when the request was created.

updatedAt · string<date-time>

Timestamp when the request was last updated (e.g., approved/rejected).