Athena
Home
Environments
Environments
  • Development Server
  • Production
Home
Environments
Environments
  • Development Server
  • Production
  1. Memory
  • Getting Started
    • Start Guide
  • Installation & Setup
    • Windows
  • Architecture
  • Guide
    • Bundles
      • Backend
    • Permissions
      • Frontend
    • Developers
      • Commit Lint
      • RESTful API
    • Workflows
      • Workflow Variables
  • API Reference
    • Authentication
      • Sign In
      • Logout
    • User
      • Get Authenticated User using Multiplai App Access Token
      • Get Authenticated User using Basic Token
    • Workspace
      • Get Workspaces Metrics
      • Get Workspaces
      • Update a Workspace
      • Retrieve a workspace
      • Delete a Workspace
    • Provider
      • Get Providers
      • Retrieve a Provider
      • Update a Provider
      • Create a Provider
      • Delete a Provider
    • Account
      • Get Accounts
      • Update an Account
      • Create an Account
      • Delete an Account
      • Retrieve an Account
    • Agent
      • Get Agents
      • Update an Agent
      • Create an Agent
      • Delete an Agent
      • Retrieve an Agent
      • Run an Agent
      • Train an Agent
      • Generate an Agent
      • Share Agent
      • Get Agent Leaderboard
    • Workflow
      • Get Workflows
      • Create a Workflow
      • Retrieve a Workflow
      • Update a Workflow
      • Delete a Workflow
      • Trigger a webhook
      • Share Workflow
      • Generate Workflow
    • Workflow Execution
      • Get Workflow Executions
      • Get Workflow Execution Counts
      • Retrieve a Workflow Execution
      • Delete a Workflow Execution
    • Prompt
      • Get Prompts
      • Create a Prompt
      • Retrieve a Prompt
      • Update a Prompt
      • Delete a Prompt
      • Run a prompt
    • Memory
      • Get Memories
        GET
      • Retrieve a Memory
        GET
      • Update a Memory
        PUT
      • Delete a Memory
        DELETE
    • Thread
      • Get Threads
      • Retrieve a Thread
      • Update a Thread
      • Delete a Thread
      • Create a Thread
      • Run a Thread
      • Generate Thread Name
    • Message
      • Get Messages
      • Retrieve a Message
      • Update a Message
      • Delete a Message
      • Create a Message
    • Large Language Model
      • Get Large Language Models
      • Retrieve a Large Language Model
    • Command Room Task
      • Store Command Room Task
      • Remove Command Room Task
    • Metrics
      • Get Agents Metrics
      • Get Workflows Metrics
      • Get Threads Metrics
      • Get Messages Metrics
      • Get Workflow Executions Metrics
  • Schemas
    • Resources
      • User
      • Workspace
      • Provider
      • Account
      • Agent
      • Workflow
      • Share
      • WorkflowExecution
      • WorkflowExecutionData
      • Prompt
      • Memory
      • Thread
      • Attachment
      • Media
      • Tool
      • Message
      • LargeLanguageModel
      • AgentLeaderboard
    • Utils
      • Pagination
        • PaginationMeta
        • PaginationLinks
      • Provider
        • AuthenticationConfig
      • Profile
        • ProfilePhotoConfig
      • Workflow
        • WorkflowExecutionDataWorkflowData
        • Node
        • Edge
  1. Memory

Get Memories

Local
https://localhost
Local
https://localhost
GET
/api/v1/memories

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Header Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://localhost/api/v1/memories?agent_uuid=550e8400-e29b-41d4-a716-446655440000&search=important meeting notes&type=semantic' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'
Response Response Example
{
    "data": [
        {
            "uuid": "9eaddb9c-f135-4cc6-b885-8b190ab86b1a",
            "content": "Cervus bellum suggero capio. Absens cruentus clarus depopulo absconditus aureus desolo ambitus. Adflicto aqua asper minima beneficium.",
            "type": "episodic",
            "metadata": {
                "agent_id": null,
                "source": null,
                "confidence": 0.7389235872228286,
                "tags": [
                    "delego"
                ],
                "importance": "low",
                "context": "commodo",
                "related_memories": [
                    "d2de8fb4-b468-f58a-4370-7ce8c37aa7e6",
                    "5e61273d-7f8a-22ab-3748-7760e3a70c18"
                ],
                "ut_a": true,
                "ex1": 78550490.91495493,
                "nisi8": 64518463.11086592,
                "officia_e": 90740164.87509656
            },
            "created_at": "2025-06-18T09:05:09.870Z",
            "updated_at": "2025-10-15",
            "agent": "Reference not found $ref: #/$defs/AgentResource"
        },
        {
            "uuid": "433fb31d-f9ee-4d3e-91f1-71165f7de53e",
            "content": "Adaugeo cohaero nostrum suasoria curo creator tempora vos constans. Corrumpo odio comburo atque curtus strues bardus. Tardus autus velit caterva angulus adaugeo.",
            "type": "episodic",
            "metadata": {
                "agent_id": null,
                "source": null,
                "confidence": null,
                "tags": null,
                "importance": "medium",
                "context": "officia Duis cillum",
                "related_memories": null,
                "aliquipcd": true,
                "laboris_": "nisi"
            },
            "created_at": "2025-06-18T14:09:46.199Z",
            "updated_at": "2024-09-28",
            "agent": null
        }
    ],
    "meta": {
        "current_page": 3,
        "from": 21,
        "last_page": 10,
        "per_page": 20,
        "to": 40,
        "total": 195,
        "path": "https://api.example.com/users"
    },
    "links": {
        "first": "https://api.example.com/users?page=1",
        "last": "https://api.example.com/users?page=10",
        "prev": "https://api.example.com/users?page=2",
        "next": "https://api.example.com/users?page=4"
    }
}
Modified at 2025-06-20 02:14:33
Previous
Memory
Next
Retrieve a Memory
Built with