> ## Documentation Index
> Fetch the complete documentation index at: https://memoram.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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.


## OpenAPI

````yaml POST /access-requests
openapi: 3.0.3
info:
  title: Memoram API v1
  description: >-
    API for interacting with the Memoram platform, managing access, memories,
    and tags.
  version: 1.0.0
  contact:
    name: Memoram Support
    url: https://memoram.app
    email: support@memoram.app
servers:
  - url: https://api.memoram.app/api/v1
    description: Production Server
security: []
tags:
  - name: Access Management
    description: >-
      Endpoints for obtaining authentication tokens and managing access requests
      to user memories.
  - name: Memory Management
    description: >-
      Endpoints for creating, retrieving, updating, and deleting user memory
      blobs.
  - name: Memory Tag Management
    description: Endpoints for retrieving memory tags.
paths:
  /access-requests:
    post:
      tags:
        - Access Management
      summary: Create Access Request
      description: >-
        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.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAccessRequest'
            example:
              memoryKey: user_provided_mem_key
              reason: DemoBot would like to access your ai memories
      responses:
        '201':
          description: Access request created successfully. Status will be 'pending'.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessRequest'
        '400':
          description: Bad Request - Invalid memoryKey or reason.
        '401':
          description: Unauthorized - Invalid or expired JWT.
        '404':
          description: Not Found - Memory Key does not exist.
      security:
        - bearerAuth: []
components:
  schemas:
    CreateAccessRequest:
      type: object
      required:
        - memoryKey
        - reason
      properties:
        memoryKey:
          type: string
          description: The user's unique Memory Key obtained from the user directly.
        reason:
          type: string
          description: >-
            A brief description of why your application needs access to the
            user's memories. This is shown to the user.
          maxLength: 255
    AccessRequest:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of the access request.
        status:
          type: string
          enum:
            - pending
            - approved
            - rejected
            - revoked
          description: The current status of the access request.
        reason:
          type: string
          description: The reason provided when creating the request.
        memoryKey:
          type: string
          description: The user's memory key associated with this request.
        user_id:
          type: string
          format: uuid
          description: >-
            The unique ID of the user this request pertains to (available once
            linked).
        aiConnectorId:
          type: string
          description: >-
            The ID of the AI Connector (developer application) that made the
            request.
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the request was created.
        updatedAt:
          type: string
          format: date-time
          description: >-
            Timestamp when the request was last updated (e.g.,
            approved/rejected).
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token obtained via `/auth/token` endpoint.

````