> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentsfleet.net/llms.txt > Use this file to discover all available pages before exploring further. # Search what a fleet remembers > Finds the fleet's entries whose key or content holds the query, ignoring case, key matches first. A fleet granted to read shared memory also gets the workspace's shared entries, each naming the fleet that wrote it. Fenced like a capture: a superseded holder gets 409 `UZ-RUN-005` naming `superseded`. ## OpenAPI ````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json post /v1/runners/me/memory/{fleet_id}/recall openapi: 3.1.0 info: title: agentsfleet Control Plane API description: API for managing workspaces, fleets, triggers, and runs. contact: name: agentsfleet url: https://agentsfleet.net license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://api.agentsfleet.net description: Production security: [] paths: /v1/runners/me/memory/{fleet_id}/recall: post: tags: - Memory summary: Search what a fleet remembers description: >- Finds the fleet's entries whose key or content holds the query, ignoring case, key matches first. A fleet granted to read shared memory also gets the workspace's shared entries, each naming the fleet that wrote it. Fenced like a capture: a superseded holder gets 409 `UZ-RUN-005` naming `superseded`. operationId: runner_recall_memory parameters: - name: fleet_id in: path description: '`UUIDv7` of the fleet.' required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/MemoryRecallRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MemoryRecallResponse' '400': description: The request could not be read content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '401': description: No credential, or one this route does not accept content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '403': description: The credential is good and lacks the capability this route requires content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '404': description: No such resource, or none this caller may see content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '409': description: The request conflicts with the resource's current state content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '413': description: The payload is over this route's ceiling content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '429': description: The instance is at its ceiling content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '500': description: The daemon failed to answer content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '503': description: A dependency this route needs is unreachable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' security: - RunnerBearerAuth: [] components: schemas: MemoryRecallRequest: type: object description: '`POST /v1/runners/me/memory/{fleet_id}/recall` request.' required: - lease_id - fencing_token - query - limit properties: fencing_token: type: integer format: int64 description: Monotonic guard; a reclaimed holder is rejected. minimum: 0 lease_id: type: string description: The lease authorizing this read. limit: type: integer description: The most entries of each kind to answer with. maximum: 50 minimum: 1 query: type: string description: Text to find in a key or content, ignoring case; empty matches all. additionalProperties: false MemoryRecallResponse: type: object description: |- `POST /v1/runners/me/memory/{fleet_id}/recall` reply: the fleet's own matches and, for a granted reader, the workspace's shared ones. required: - memory properties: memory: type: array items: $ref: '#/components/schemas/MemoryDelta' description: The fleet's own entries, key matches first. shared: type: array items: $ref: '#/components/schemas/SharedMemory' description: Other fleets' shared entries, key matches first. ProblemBody: type: object description: The body every refusal carries, under `application/problem+json`. required: - docs_uri - title - detail - error_code - request_id properties: action_id: type: - string - 'null' description: 'On that 409 only: the action the gate held.' current_state: type: - string - 'null' description: 'On a 409 only: the state that forbade the transition.' detail: type: string description: One sentence on what was refused and why. docs_uri: type: string description: Where the error code is documented. error_code: type: string description: The registry code, stable across releases. etag: type: - string - 'null' description: >- On a 412 only: the resource's current entity tag, to refetch and retry. gate_id: type: - string - 'null' description: 'On an answered approval gate''s 409 only: the gate that was answered.' outcome: type: - string - 'null' description: 'On that 409 only: the answer that stands.' request_id: type: string description: The request this refusal answers, for support. resolved_at: type: - integer - 'null' format: int64 description: 'On that 409 only: when the standing answer was given.' resolved_by: type: - string - 'null' description: 'On that 409 only: who gave it.' title: type: string description: A short name for the refusal, safe to show a person. user_message: type: - string - 'null' description: A curated sentence for end users, where the code has one. MemoryDelta: type: object description: One durable memory item — the unit of both reading and writing. required: - key - content - category properties: category: type: string description: Retention category, which decides eviction order. content: type: string description: The remembered content. key: type: string description: Stable key. A repeated key overwrites rather than accumulating. visibility: $ref: '#/components/schemas/Visibility' description: >- Who reads it; absent means the writing fleet alone. Left off the wire at that default, so a delta that shares nothing reads as it always did. SharedMemory: type: object description: An entry another fleet in the workspace published, and who wrote it. required: - key - content - category - writer_fleet_id - writer_fleet_name - updated_at properties: category: type: string description: The writer's retention category. content: type: string description: What its writer remembered. key: type: string description: The key its writer stored it under. updated_at: type: integer format: int64 description: Epoch milliseconds of its last write. writer_fleet_id: type: string description: The fleet that wrote it, and the only fleet that may change it. writer_fleet_name: type: string description: That fleet's name in the workspace. Visibility: type: string description: |- Who reads a stored entry: its own fleet, or every fleet in the workspace granted to read shared memory. enum: - fleet - workspace securitySchemes: RunnerBearerAuth: type: http scheme: bearer bearerFormat: agt_r description: The opaque agt_r token minted when the runner enrols (POST /v1/runners) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.