Memories

List memories in a namespace

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

Query Parameters

thread_id?|

Filter by thread ID

memory_type?|

Filter by memory type

include_expired?Include Expired

Include expired memories

Defaultfalse

limit?Limit

Maximum number of items to return (1-500)

Default100

Range1 <= value <= 500

cursor?|

Cursor for pagination (from previous response's next_cursor)

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories"

{
  "total": 0,
  "has_more": false,
  "next_cursor": "string",
  "memories": [
    {
      "memory_id": "string",
      "workspace_id": "string",
      "namespace_id": "string",
      "thread_id": "string",
      "key": "string",
      "content": "string",
      "content_preview": "string",
      "memory_type": "fact",
      "memory_scope": "namespace",
      "importance": 0,
      "ttl_seconds": 0,
      "expires_at": "string",
      "metadata": {},
      "tags": [],
      "source": "augmentation",
      "source_augmentation_id": "string",
      "source_step_id": "string",
      "status": "active",
      "is_indexed": true,
      "indexed_at": "string",
      "index_error": "string",
      "index_attempts": 0,
      "embedding_model_id": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Create a new memory

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

Header Parameters

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

content*|

Memory content (text or structured JSON)

key?|

Unique key for upsert semantics

memory_type?MemoryType

Type of memory

Default"fact"

thread_id?|

Associate with specific thread (optional)

importance?Importance

Importance score

Default1

Range0 <= value <= 1

ttl_seconds?|

Time-to-live (None = permanent)

metadata?

Additional metadata

tags?array<string>

Tags for filtering

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories" \  -H "Content-Type: application/json" \  -d '{    "content": "string"  }'

{
  "message": "Memory created successfully",
  "memory": {
    "memory_id": "string",
    "workspace_id": "string",
    "namespace_id": "string",
    "thread_id": "string",
    "key": "string",
    "content": "string",
    "content_preview": "string",
    "memory_type": "fact",
    "memory_scope": "namespace",
    "importance": 0,
    "ttl_seconds": 0,
    "expires_at": "string",
    "metadata": {},
    "tags": [],
    "source": "augmentation",
    "source_augmentation_id": "string",
    "source_step_id": "string",
    "status": "active",
    "is_indexed": true,
    "indexed_at": "string",
    "index_error": "string",
    "index_attempts": 0,
    "embedding_model_id": "string",
    "created_at": "string",
    "updated_at": "string"
  },
  "was_upsert": false
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Clear all memories in namespace

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

Query Parameters

confirm?Confirm

Must be true to confirm deletion

Defaultfalse

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X DELETE "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories"

null

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Get a memory by ID

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

memory_id*Memory Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories/string"

{
  "memory_id": "string",
  "workspace_id": "string",
  "namespace_id": "string",
  "thread_id": "string",
  "key": "string",
  "content": "string",
  "content_preview": "string",
  "memory_type": "fact",
  "memory_scope": "namespace",
  "importance": 0,
  "ttl_seconds": 0,
  "expires_at": "string",
  "metadata": {},
  "tags": [],
  "source": "augmentation",
  "source_augmentation_id": "string",
  "source_step_id": "string",
  "status": "active",
  "is_indexed": true,
  "indexed_at": "string",
  "index_error": "string",
  "index_attempts": 0,
  "embedding_model_id": "string",
  "created_at": "string",
  "updated_at": "string"
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Delete a memory

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

memory_id*Memory Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X DELETE "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories/string"

{
  "message": "Memory deleted successfully",
  "memory_id": "string",
  "embedding_deleted": false
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Update a memory

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

memory_id*Memory Id

Header Parameters

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

content?||

Updated content

memory_type?|

Updated memory type

importance?|

Updated importance

ttl_seconds?|

Updated TTL

metadata?|

Updated metadata (merged with existing)

tags?array<string>|

Updated tags

status?|

Updated status

Response Body

`application/json`

curl -X PUT "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "message": "Memory updated successfully",
  "memory": {
    "memory_id": "string",
    "workspace_id": "string",
    "namespace_id": "string",
    "thread_id": "string",
    "key": "string",
    "content": "string",
    "content_preview": "string",
    "memory_type": "fact",
    "memory_scope": "namespace",
    "importance": 0,
    "ttl_seconds": 0,
    "expires_at": "string",
    "metadata": {},
    "tags": [],
    "source": "augmentation",
    "source_augmentation_id": "string",
    "source_step_id": "string",
    "status": "active",
    "is_indexed": true,
    "indexed_at": "string",
    "index_error": "string",
    "index_attempts": 0,
    "embedding_model_id": "string",
    "created_at": "string",
    "updated_at": "string"
  }
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Query memories (semantic search)

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

Header Parameters

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*Query

Search query text

workspace_id*Workspace Id

Workspace to search in

namespace_id?|

Namespace to search in (required for namespace/thread scope)

thread_id?|

Thread to search in (for thread scope)

search_scope?MemorySearchScope

Where to search

Default"namespace"

Value in"thread" | "namespace" | "workspace"

include_parent_scopes?Include Parent Scopes

When thread scope, also include namespace-level memories

Defaulttrue

memory_types?array<>|

Filter by memory types

tags?array<string>|

Filter by tags (any match)

min_importance?|

Minimum importance score

include_expired?Include Expired

Include expired memories

Defaultfalse

top_k?Top K

Number of results

Default10

Range1 <= value <= 100

score_threshold?Score Threshold

Minimum similarity score

Default0.7

Range0 <= value <= 1

include_content?Include Content

Include memory content in results

Defaulttrue

include_metadata?Include Metadata

Include metadata in results

Defaulttrue

build_combined_context?Build Combined Context

Build concatenated context string

Defaulttrue

context_separator?Context Separator

Separator for combined context

Default"\n\n---\n\n"

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories/query" \  -H "Content-Type: application/json" \  -d '{    "query": "string",    "workspace_id": "string"  }'

{
  "results": [
    {
      "memory_id": "string",
      "content": "string",
      "content_text": "string",
      "score": 0,
      "memory_type": "fact",
      "memory_scope": "namespace",
      "importance": 0,
      "thread_id": "string",
      "namespace_id": "string",
      "tags": [],
      "metadata": {},
      "created_at": "string"
    }
  ],
  "total_results": 0,
  "query": "string",
  "combined_context": "string",
  "search_scope": "thread",
  "namespace_id": "string",
  "thread_id": "string"
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Re-index all memories in namespace

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/memories/reindex"

null

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

List memories for a thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

thread_id*Thread Id

Query Parameters

memory_type?|

Filter by memory type

include_namespace?Include Namespace

Include namespace-level memories

Defaulttrue

include_expired?Include Expired

Include expired memories

Defaultfalse

limit?Limit

Maximum number of items to return (1-500)

Default100

Range1 <= value <= 500

cursor?|

Cursor for pagination (from previous response's next_cursor)

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/threads/string/memories"

{
  "total": 0,
  "has_more": false,
  "next_cursor": "string",
  "memories": [
    {
      "memory_id": "string",
      "workspace_id": "string",
      "namespace_id": "string",
      "thread_id": "string",
      "key": "string",
      "content": "string",
      "content_preview": "string",
      "memory_type": "fact",
      "memory_scope": "namespace",
      "importance": 0,
      "ttl_seconds": 0,
      "expires_at": "string",
      "metadata": {},
      "tags": [],
      "source": "augmentation",
      "source_augmentation_id": "string",
      "source_step_id": "string",
      "status": "active",
      "is_indexed": true,
      "indexed_at": "string",
      "index_error": "string",
      "index_attempts": 0,
      "embedding_model_id": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Clear thread-specific memories

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

app_id*App Id

namespace_id*Namespace Id

thread_id*Thread Id

Query Parameters

confirm?Confirm

Must be true to confirm deletion

Defaultfalse

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X DELETE "https://loading/v1/orgs/string/workspaces/string/apps/string/namespaces/string/threads/string/memories"

null

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`