> ## 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 learning runs > Returns memory learning runs, newest first. Each names the sessions whose reports it read, the collection it updated, and the session that ran it. That session is an ordinary session, so streaming it shows the run's reasoning as it happens. ## OpenAPI ````yaml /managed-agents/openapi.yaml get /managed-agents/v1/reflections 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/reflections: get: tags: - Memory summary: List learning runs description: >- Returns memory learning runs, newest first. Each names the sessions whose reports it read, the collection it updated, and the session that ran it. That session is an ordinary session, so streaming it shows the run's reasoning as it happens. operationId: managedAgentsListReflections parameters: - description: Only runs for this agent. in: query name: agent_id schema: description: Only runs for this agent. type: string - description: Only runs in this state. in: query name: status schema: description: Only runs in this state. enum: - pending - running - completed - failed - canceled type: string - description: Only runs started this way. in: query name: triggered_by schema: description: Only runs started this way. enum: - schedule - counter - manual type: string - description: Maximum runs to return. Defaults to 50. in: query name: limit schema: description: Maximum runs to return. Defaults to 50. type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsReflectionListResponse' description: Memory learning runs, newest first. '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' '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: ManagedAgentsReflectionListResponse: description: Memory learning runs, newest first. properties: reflections: description: Memory learning runs, newest first. items: $ref: '#/components/schemas/ManagedAgentsReflection' type: - array - 'null' required: - reflections type: object 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. 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. ````