> ## Documentation Index > Fetch the complete documentation index at: https://docs.labelbox.com/llms.txt > Use this file to discover all available pages before exploring further. # List an agent's memory activity > Returns automatic memory updates and checks, newest first, including unchanged checks and failed attempts. ## OpenAPI ````yaml /managed-agents/openapi.yaml get /managed-agents/v1/agents/{agent_id}/memory/activity openapi: 3.1.0 info: title: Managed Agents API version: 0.14.0 description: >- The Recursion Managed Agents REST API. Authenticate with a Recursion API key as a bearer token. An organization-scoped key acts in its own organization and needs nothing else; a tenant-scoped key must also send `x-organization-id` with an organization id or `default`. Field names follow each operation's published schema. servers: - url: https://api.recursion.labelbox.com security: - bearerAuth: [] paths: /managed-agents/v1/agents/{agent_id}/memory/activity: get: tags: - Memory summary: List an agent's memory activity description: >- Returns automatic memory updates and checks, newest first, including unchanged checks and failed attempts. operationId: managedAgentsListAgentMemoryActivity parameters: - description: Opaque next_cursor from the previous activity page. in: query name: cursor schema: description: Opaque next_cursor from the previous activity page. type: string - description: Page size from 1 through 100, default 50. in: query name: limit schema: default: 50 description: Page size from 1 through 100, default 50. maximum: 100 minimum: 1 type: integer - description: Agent whose automatic memory runs are listed. in: path name: agent_id required: true schema: description: Agent whose automatic memory runs are listed. format: uuid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsMemoryActivityPage' description: >- An agent's automatic memory activity, including checks with no changes and retrying failures. '400': description: The request was rejected by schema or semantic validation. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorInvalidRequest' '401': description: The caller is unauthenticated. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorUnauthorized' '403': description: The caller lacks a required permission or capability. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden' '404': description: No such resource is reachable for this caller. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorNotFound' '429': headers: Retry-After: description: When to retry, as delay seconds or an HTTP date. schema: type: string description: A rate limit is exhausted. Honor `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorRateLimitExceeded' '500': description: An unexpected server-side failure. content: application/json: schema: oneOf: - $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError' - $ref: >- #/components/schemas/ManagedAgentsApiErrorInvariantViolation discriminator: propertyName: code mapping: internal_error: $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError' invariant_violation: $ref: >- #/components/schemas/ManagedAgentsApiErrorInvariantViolation '502': description: The service returned an invalid response. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorBadGateway' '503': description: >- A dependency is unavailable. Consult details.retryable and Retry-After when present before retrying. content: application/json: schema: oneOf: - $ref: >- #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable - $ref: >- #/components/schemas/ManagedAgentsApiErrorServiceUnavailable discriminator: propertyName: code mapping: managed_agents_unavailable: $ref: >- #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable service_unavailable: $ref: >- #/components/schemas/ManagedAgentsApiErrorServiceUnavailable '504': description: The service did not respond before the timeout. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorGatewayTimeout' components: schemas: ManagedAgentsMemoryActivityPage: description: >- An agent's automatic memory activity, including checks with no changes and retrying failures. properties: next_cursor: description: Opaque cursor for the next activity page. type: string reflections: description: Automatic memory runs, newest first. items: $ref: '#/components/schemas/ManagedAgentsReflection' type: array required: - reflections type: object example: next_cursor: example reflections: - added_count: 1 agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d base_revision: 1 created_at: '2026-02-18T09:30:00.000Z' digest_count: 1 driver_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d ended_at: '2026-02-18T09:30:00.000Z' error_message: example error_type: example input_session_ids: - example instructions: example memory_store_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d merged_count: 1 model: example model_ref_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d organization_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d reflection_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d retired_count: 1 status: pending trigger_window: example triggered_by: schedule updated_at: '2026-02-18T09:30:00.000Z' updated_count: 1 ManagedAgentsApiErrorInvalidRequest: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - invalid_request message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorUnauthorized: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - unauthorized message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorForbidden: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - forbidden message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorNotFound: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - not_found message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorRateLimitExceeded: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - rate_limit_exceeded message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorInternalError: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - internal_error message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorInvariantViolation: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - invariant_violation message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorBadGateway: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - bad_gateway message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorManagedAgentsUnavailable: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - managed_agents_unavailable message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorServiceUnavailable: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - service_unavailable message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorGatewayTimeout: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - gateway_timeout message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsReflection: description: >- One learning run: it reads reports from an agent's finished sessions and applies a set of changes to the agent's learned memory in one step. It runs as an ordinary session, so the whole run is readable through driver_session_id. properties: added_count: description: Memories added by this run. format: int64 type: integer agent_id: description: Agent whose memory this run curates. type: string agent_version_id: description: Version of the agent under study when the run started. type: string base_revision: description: Collection revision read by this run. format: int64 type: integer created_at: description: Server-assigned RFC 3339 timestamp of when the run was created. format: date-time type: string digest_count: description: Number of session reports read. format: int64 type: integer driver_session_id: description: >- Session that ran this learning run. Read or stream its events to follow the run. type: string ended_at: description: Set when the run reached a terminal status. format: date-time type: string error_message: description: Human-readable failure detail. type: string error_type: description: Classification of a failure. type: string input_session_ids: description: Sessions whose reports this run read. items: type: string type: array instructions: description: >- Standing guidance for what this run should learn. Capped at 4096 characters. type: string memory_store_id: description: Stable memory collection updated by this run. type: string merged_count: description: Memories merged into another memory. format: int64 type: integer model: description: >- Model id that ran this learning run. Empty when model_ref_id names a model reference instead. type: string model_ref_id: description: >- Model reference id that ran this learning run. Empty when model names the model instead. type: string organization_id: description: Organization that owns this record. type: string reflection_id: description: Server-assigned id of the run. type: string retired_count: description: Memories retired without a replacement. format: int64 type: integer status: description: Where the run is. enum: - pending - running - completed - failed - canceled type: string trigger_window: description: >- Identifier of the occasion that started the run. Unique per agent, so one occasion never starts two runs. type: string triggered_by: description: >- What started the run: the regular schedule, enough new session reports, or an operator. enum: - schedule - counter - manual type: string updated_at: description: Server-assigned RFC 3339 timestamp of the most recent change. format: date-time type: string updated_count: description: Existing memories refined by this run. format: int64 type: integer required: - organization_id - reflection_id - agent_id - memory_store_id - base_revision - added_count - updated_count - retired_count - merged_count - status - triggered_by - created_at - updated_at type: object example: added_count: 1 agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d base_revision: 1 created_at: '2026-02-18T09:30:00.000Z' digest_count: 1 driver_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d ended_at: '2026-02-18T09:30:00.000Z' error_message: example error_type: example input_session_ids: - example instructions: example memory_store_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d merged_count: 1 model: example model_ref_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d organization_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d reflection_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d retired_count: 1 status: pending trigger_window: example triggered_by: schedule updated_at: '2026-02-18T09:30:00.000Z' updated_count: 1 ManagedAgentsApiErrorDetails: type: object properties: field: description: >- Request field or header responsible for the error, when one can be identified. type: string issues: description: >- Boundary-validation failures as path-prefixed human-readable messages. type: array items: type: string requestId: description: Request correlation identifier for support and log lookup. type: string retryable: description: >- Server advice about failure transience. `true` means transient, `false` means non-transient, and absence gives no advice. Automatic replay is allowed only when this field is not `false` and the operation-specific retry and idempotency contract permits replay. type: boolean additionalProperties: {} description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. securitySchemes: bearerAuth: type: http scheme: bearer description: A Recursion API key, created in the console under API keys. ````