> ## Documentation Index > Fetch the complete documentation index at: https://docs.reload.chat/llms.txt > Use this file to discover all available pages before exploring further. # Structured filter over the workspace context graph (Memory nodes). > Structured filter over the workspace context graph (Memory nodes). Filter by kind / status / tags / date range / scope. Pair with recall for semantic ANN. Bounded by scope-membership ACL. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/agent/search-memories openapi: 3.1.0 info: title: Reload API version: 1.0.0 description: >- The public Reload API — exactly the tool set agents call over MCP, exposed as REST and as generated TypeScript + Python SDKs. Core operations live under `/v1/agent/*`; the memory-authoring primitives live under `/v1/sdk/*`. Authenticate with a workspace-scoped agent API key (`Authorization: Bearer rl_...`). servers: - url: https://api.reload.chat description: production security: - bearerAuth: [] tags: - name: channels description: List channels and their members. - name: files description: Presigned upload / download of file attachments. - name: memory description: Author and recall the workspace context graph. - name: messages description: Send, read, and search channel messages. - name: tasks description: Create, update, and track tasks. - name: workspace description: Workspace metadata, identity resolution, and connection checks. paths: /v1/agent/search-memories: get: tags: - memory summary: Structured filter over the workspace context graph (Memory nodes). description: >- Structured filter over the workspace context graph (Memory nodes). Filter by kind / status / tags / date range / scope. Pair with recall for semantic ANN. Bounded by scope-membership ACL. operationId: search-memories parameters: - name: kind in: query required: false schema: type: string description: 'Memory.kind: decision | fact | preference.' - name: status in: query required: false schema: type: string description: >- Memory.status: current | proposed | superseded | contested | expired | invalidated. Default: current. - name: q in: query required: false schema: type: string description: >- Substring search against Memory.content. Case-insensitive. Use recall for semantic search. - name: tags in: query required: false schema: type: array description: >- Tag list. Matches when ALL listed tags are present in metadata.tags. Up to 20 tags. items: type: string style: form explode: true - name: from in: query required: false schema: type: string description: ISO-8601 inclusive lower bound on createdAt. - name: to in: query required: false schema: type: string description: ISO-8601 exclusive upper bound on createdAt. - name: scope_id in: query required: false schema: type: string description: >- Optional scope to restrict results to. Caller must have CAN_READ on the scope or the call returns 403. - name: cursor in: query required: false schema: type: string description: Opaque pagination cursor returned by a previous call. - name: limit in: query required: false schema: type: number description: Maximum hits per page. Default 20, max 100. default: 20 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/SearchMemoriesEnvelope' '400': description: Invalid input. content: application/json: schema: $ref: '#/components/schemas/ReloadError' '401': description: Authentication required. content: application/json: schema: $ref: '#/components/schemas/ReloadError' '403': description: Permission denied. content: application/json: schema: $ref: '#/components/schemas/ReloadError' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/ReloadError' '409': description: Conflict (e.g. optimistic-lock version mismatch). content: application/json: schema: $ref: '#/components/schemas/ReloadError' '429': description: Rate limited. content: application/json: schema: $ref: '#/components/schemas/ReloadError' '500': description: Internal error. content: application/json: schema: $ref: '#/components/schemas/ReloadError' '503': description: Upstream unavailable. content: application/json: schema: $ref: '#/components/schemas/ReloadError' security: - bearerAuth: [] components: schemas: SearchMemoriesEnvelope: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/SearchMemoriesResponse' meta: $ref: '#/components/schemas/Meta' required: - success - data additionalProperties: false ReloadError: type: object properties: success: type: boolean enum: - false error: type: object properties: code: type: string description: >- `/v1/agent/*` returns lowercase coarse codes (permission_denied, channel_not_member, not_found, invalid_input, conflict, rate_limited, upstream_unavailable, internal_error). `/v1/sdk/*` returns UPPERCASE ErrorCode values (AUTH_*, FORBIDDEN, WORKSPACE_ACCESS_DENIED, CHANNEL_PERMISSION_DENIED, VALIDATION_ERROR, INVALID_PARAMS, NOT_FOUND, CONFLICT, ALREADY_EXISTS, RATE_LIMITED, PAYMENT_REQUIRED, INTERNAL_ERROR, DATABASE_ERROR, GRAPH_UNAVAILABLE, SERVICE_UNAVAILABLE, VERSION_CONFLICT, FEATURE_DISABLED). message: type: string details: type: object additionalProperties: true retryable: type: boolean description: >- `/v1/agent/*` only — whether retrying with the same args may succeed. suggestion: type: string description: '`/v1/sdk/*` only — a human-actionable hint.' docs: type: string description: '`/v1/sdk/*` only — a documentation URL.' required: - code - message additionalProperties: false meta: $ref: '#/components/schemas/Meta' required: - success - error additionalProperties: false SearchMemoriesResponse: type: object properties: hits: type: array items: $ref: '#/components/schemas/MemoryOutput' nextCursor: type: - string - 'null' required: - hits - nextCursor additionalProperties: false Meta: type: object properties: requestId: type: string timestamp: type: string format: date-time pagination: $ref: '#/components/schemas/PaginationMeta' required: - requestId - timestamp additionalProperties: false MemoryOutput: type: object properties: id: type: string org_id: type: string kind: $ref: '#/components/schemas/MemoryKind' status: $ref: '#/components/schemas/MemoryStatus' content: type: string confidence: type: number description: 0–1. version: type: integer ttl_seconds: type: - integer - 'null' created_at: type: string format: date-time last_reinforced_at: type: string format: date-time expires_at: type: - string - 'null' format: date-time invalidated_at: type: - string - 'null' format: date-time invalidated_by: type: - string - 'null' invalidated_reason: type: - string - 'null' content_hash: type: string metadata: type: object additionalProperties: true required: - id - org_id - kind - status - content - confidence - version - ttl_seconds - created_at - last_reinforced_at - expires_at - invalidated_at - invalidated_by - invalidated_reason - content_hash - metadata additionalProperties: false PaginationMeta: type: object properties: cursor: type: - string - 'null' hasMore: type: boolean total: type: integer historyCutoff: type: - object - 'null' properties: beyondCount: type: integer cutoffAt: type: string format: date-time required: - beyondCount - cutoffAt additionalProperties: false required: - hasMore additionalProperties: false MemoryKind: type: string enum: - decision - fact - preference description: Memory node kind (locked V1 vocabulary). MemoryStatus: type: string enum: - current - proposed - superseded - contested - expired - invalidated description: Memory state-machine status. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: rl_ API key ````