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

# Send feedback

> Report a bug, request a feature or flag a docs problem to the Supermemory team. Built for AI agents: send structured JSON and an engineer picks it up.

Authentication is optional for requests with a usable client IP. Cross-zone Cloudflare Worker requests and requests without a client IP must provide an API key. With an API key the limit is 3 submissions per organization per UTC day; without one it is 3 per IPv4 address or IPv6 /64, shared with everyone behind that address. Authenticated submissions have a separate 200/day pool; anonymous submissions share a 20/day pool. Pass your API key to get your own quota.



## OpenAPI

````yaml https://api.supermemory.ai/v5/openapi post /feedback
openapi: 3.1.0
info:
  title: supermemory API
  description: >-
    The Memory API for the AI era. OpenAPI operations include x-codeSamples for
    the official TypeScript and Python SDKs (Mintlify-compatible).
  version: 5.0.0
servers:
  - description: Production Server
    url: https://api.supermemory.ai
security:
  - bearerAuth: []
tags:
  - name: Ingest
    description: Ingest documents, files, URLs, conversations, and other content
  - name: Recall (Search)
    description: >-
      Semantic recall across your content — supports memories, hybrid, and
      documents modes
  - name: Profiles
    description: Maintained static, dynamic, and custom-bucket profiles scoped by namespace
  - name: Content Management
    description: List, get, update, and delete content and memories
  - name: Namespaces
    description: List and manage isolated namespaces and their settings
  - name: Connectors
    description: >-
      Sync external sources such as Google Drive, Notion and GitHub into a
      namespace
  - name: Organization
    description: Read and update organization-wide settings
  - name: Feedback
    description: Report bugs, request features, and flag documentation issues
paths:
  /feedback:
    post:
      tags:
        - Feedback
      summary: Send feedback
      description: >-
        Report a bug, request a feature or flag a docs problem to the
        Supermemory team. Built for AI agents: send structured JSON and an
        engineer picks it up.


        Authentication is optional for requests with a usable client IP.
        Cross-zone Cloudflare Worker requests and requests without a client IP
        must provide an API key. With an API key the limit is 3 submissions per
        organization per UTC day; without one it is 3 per IPv4 address or IPv6
        /64, shared with everyone behind that address. Authenticated submissions
        have a separate 200/day pool; anonymous submissions share a 20/day pool.
        Pass your API key to get your own quota.
      operationId: postFeedback
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - bug
                    - feature_request
                    - docs
                    - other
                  description: Kind of feedback
                  example: bug
                title:
                  type: string
                  minLength: 1
                  maxLength: 120
                  description: One-line summary
                  example: Search returns no results for documents still in indexing
                description:
                  type: string
                  minLength: 1
                  maxLength: 5000
                  description: >-
                    What happened, with enough detail for an engineer to act on
                    it
                  example: >-
                    Documents added less than a minute ago are missing from
                    /v4/search results even though GET /v3/documents/{id}
                    reports status done.
                endpoint:
                  description: API operation the feedback is about
                  example: POST /v4/search
                  type: string
                  maxLength: 200
                requestId:
                  description: Request ID of a failing call, if there is one
                  type: string
                  maxLength: 200
                expected:
                  description: What you expected to happen
                  type: string
                  maxLength: 2000
                actual:
                  description: What actually happened
                  type: string
                  maxLength: 2000
                client:
                  description: Agent, tool or SDK sending the feedback
                  example: claude-code/2.1, supermemory-sdk-ts/5.0.0
                  type: string
                  maxLength: 200
                contactEmail:
                  description: Where to reach you about this feedback
                  type: string
                  maxLength: 320
                  format: email
                  pattern: >-
                    ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
              required:
                - type
                - title
                - description
      responses:
        '202':
          description: Feedback received
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Feedback reference
                    example: fb_k3m9q2x7wd
                  remaining:
                    type: number
                    description: Submissions left for this caller until 00:00 UTC
                    example: 2
                required:
                  - id
                  - remaining
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/ValidationErrorResponse'
        '401':
          description: An API key is invalid or required for this request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: The API key cannot access this endpoint or namespace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: >-
            Daily limit reached. The Retry-After header gives the seconds until
            it resets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            Slack rejected the feedback or delivery could not be confirmed. Only
            confirmed rejections are refunded; do not automatically retry
            uncertain deliveries.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Feedback is not available on this deployment
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - {}
        - bearerAuth: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X POST "https://api.supermemory.ai/feedback" \
              -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                "type": "bug",
                "title": "Search misses documents added in the last minute",
                "description": "Documents report status done but do not appear in /v4/search for about a minute.",
                "endpoint": "POST /v4/search",
                "client": "my-agent/1.0"
              }'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
          example: Invalid request parameters
        details:
          type: string
          description: Additional error details
          example: Query must be at least 1 character long
      required:
        - error
    ValidationErrorResponse:
      type: object
      description: Body returned when request input fails schema validation
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: array
          description: Validation issues
          items:
            type: object
            properties:
              message:
                type: string
              path:
                type: array
                items:
                  oneOf:
                    - type: string
                    - type: number
            required:
              - message
        data:
          description: The input that failed validation
      required:
        - success
        - error
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.