openapi: 3.0.1
info:
  title: Mem0 API Docs agents events API
  description: mem0.ai API Docs
  contact:
    email: support@mem0.ai
  license:
    name: Apache 2.0
  version: v1
servers:
- url: https://api.mem0.ai/
security:
- ApiKeyAuth: []
tags:
- name: events
paths:
  /v1/events/:
    get:
      tags:
      - events
      summary: Retrieve all events for current organization and project.
      operationId: events_list
      responses:
        '200':
          description: Successfully retrieved events.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    description: Total number of events matching the filters.
                  next:
                    type: string
                    nullable: true
                    description: URL for the next page of results.
                  previous:
                    type: string
                    nullable: true
                    description: URL for the previous page of results.
                  results:
                    type: array
                    description: Array of event objects.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: The unique identifier of the event.
                        event_type:
                          type: string
                          description: The type of event (e.g., ADD, SEARCH).
                        status:
                          type: string
                          enum:
                          - PENDING
                          - RUNNING
                          - FAILED
                          - SUCCEEDED
                          description: The current status of the event.
                        payload:
                          type: object
                          description: The original payload associated with the event.
                        metadata:
                          type: object
                          nullable: true
                          description: Additional metadata associated with the event.
                        results:
                          type: array
                          description: Array of results produced by the event. For add events, this confirms the write completed; temporal reasoning enrichment runs asynchronously by default.
                        created_at:
                          type: string
                          format: date-time
                          description: Timestamp when the event was created.
                        updated_at:
                          type: string
                          format: date-time
                          description: Timestamp when the event was last updated.
                        started_at:
                          type: string
                          format: date-time
                          description: Timestamp when event processing started.
                        completed_at:
                          type: string
                          format: date-time
                          description: Timestamp when event processing completed.
                        latency:
                          type: number
                          description: Processing time in milliseconds.
                required:
                - count
                - results
      x-code-samples:
      - lang: Python
        source: 'import requests


          url = "https://api.mem0.ai/v1/events/"


          headers = {"Authorization": "Token <api-key>"}


          response = requests.request("GET", url, headers=headers)


          print(response.text)'
      - lang: JavaScript
        source: "const options = {method: 'GET', headers: {Authorization: 'Token <api-key>'}};\n\nfetch('https://api.mem0.ai/v1/events/', options)\n  .then(response => response.json())\n  .then(response => console.log(response))\n  .catch(err => console.error(err));"
      - lang: cURL
        source: "curl --request GET \\\n  --url https://api.mem0.ai/v1/events/ \\\n  --header 'Authorization: Token <api-key>'"
      - lang: Go
        source: "package main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"io/ioutil\"\n)\n\nfunc main() {\n\n\turl := \"https://api.mem0.ai/v1/events/\"\n\n\treq, _ := http.NewRequest(\"GET\", url, nil)\n\n\treq.Header.Add(\"Authorization\", \"Token <api-key>\")\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\tbody, _ := ioutil.ReadAll(res.Body)\n\n\tfmt.Println(res)\n\tfmt.Println(string(body))\n\n}"
      - lang: PHP
        source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n  CURLOPT_URL => \"https://api.mem0.ai/v1/events/\",\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => \"\",\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 30,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => \"GET\",\n  CURLOPT_HTTPHEADER => [\n    \"Authorization: Token <api-key>\"\n  ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n  echo \"cURL Error #:\" . $err;\n} else {\n  echo $response;\n}"
      - lang: Java
        source: "HttpResponse<String> response = Unirest.get(\"https://api.mem0.ai/v1/events/\")\n  .header(\"Authorization\", \"Token <api-key>\")\n  .asString();"
  /v1/event/{event_id}/:
    get:
      tags:
      - events
      summary: Retrieve details of a specific event by its ID.
      operationId: event_read
      parameters:
      - name: event_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: The unique identifier of the event (UUID).
      responses:
        '200':
          description: Successfully retrieved event details.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: The unique identifier of the event.
                  event_type:
                    type: string
                    description: The type of event (e.g., ADD, SEARCH).
                  status:
                    type: string
                    enum:
                    - PENDING
                    - RUNNING
                    - FAILED
                    - SUCCEEDED
                    description: The current status of the event.
                  payload:
                    type: object
                    description: The original payload associated with the event.
                  metadata:
                    type: object
                    nullable: true
                    description: Additional metadata associated with the event.
                  results:
                    type: array
                    description: Array of results produced by the event.
                  created_at:
                    type: string
                    format: date-time
                    description: Timestamp when the event was created.
                  updated_at:
                    type: string
                    format: date-time
                    description: Timestamp when the event was last updated.
                  started_at:
                    type: string
                    format: date-time
                    description: Timestamp when event processing started.
                  completed_at:
                    type: string
                    format: date-time
                    description: Timestamp when event processing completed.
                  latency:
                    type: number
                    description: Processing time in milliseconds.
        '404':
          description: Event not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
      x-code-samples:
      - lang: Python
        source: 'import requests


          url = "https://api.mem0.ai/v1/event/{event_id}/"


          headers = {"Authorization": "Token <api-key>"}


          response = requests.request("GET", url, headers=headers)


          print(response.text)'
      - lang: JavaScript
        source: "const options = {method: 'GET', headers: {Authorization: 'Token <api-key>'}};\n\nfetch('https://api.mem0.ai/v1/event/{event_id}/', options)\n  .then(response => response.json())\n  .then(response => console.log(response))\n  .catch(err => console.error(err));"
      - lang: cURL
        source: "curl --request GET \\\n  --url https://api.mem0.ai/v1/event/{event_id}/ \\\n  --header 'Authorization: Token <api-key>'"
      - lang: Go
        source: "package main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"io/ioutil\"\n)\n\nfunc main() {\n\n\turl := \"https://api.mem0.ai/v1/event/{event_id}/\"\n\n\treq, _ := http.NewRequest(\"GET\", url, nil)\n\n\treq.Header.Add(\"Authorization\", \"Token <api-key>\")\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\tbody, _ := ioutil.ReadAll(res.Body)\n\n\tfmt.Println(res)\n\tfmt.Println(string(body))\n\n}"
      - lang: PHP
        source: "<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, [\n  CURLOPT_URL => \"https://api.mem0.ai/v1/event/{event_id}/\",\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_ENCODING => \"\",\n  CURLOPT_MAXREDIRS => 10,\n  CURLOPT_TIMEOUT => 30,\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n  CURLOPT_CUSTOMREQUEST => \"GET\",\n  CURLOPT_HTTPHEADER => [\n    \"Authorization: Token <api-key>\"\n  ],\n]);\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n  echo \"cURL Error #:\" . $err;\n} else {\n  echo $response;\n}"
      - lang: Java
        source: "HttpResponse<String> response = Unirest.get(\"https://api.mem0.ai/v1/event/{event_id}/\")\n  .header(\"Authorization\", \"Token <api-key>\")\n  .asString();"
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key authentication. Prefix your Mem0 API key with ''Token ''. Example: ''Token your_api_key'''
x-original-swagger-version: '2.0'