> ## 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 memory versions

> Returns a store's change history, newest first, optionally filtered to one memory. Versions belong to the store rather than the memory, so the trail survives the memory being deleted. Retained 30 days, except that the recent versions of a live memory are kept regardless of age.



## OpenAPI

````yaml /managed-agents/openapi.yaml get /managed-agents/v1/memory_stores/{memory_store_id}/memory_versions
openapi: 3.1.0
info:
  title: Managed Agents API
  version: 0.13.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/memory_stores/{memory_store_id}/memory_versions:
    get:
      tags:
        - Memory
      summary: List memory versions
      description: >-
        Returns a store's change history, newest first, optionally filtered to
        one memory. Versions belong to the store rather than the memory, so the
        trail survives the memory being deleted. Retained 30 days, except that
        the recent versions of a live memory are kept regardless of age.
      operationId: managedAgentsListMemoryVersions
      parameters:
        - description: >-
            Only versions of this memory. The memory may since have been
            deleted.
          in: query
          name: memory_id
          schema:
            description: >-
              Only versions of this memory. The memory may since have been
              deleted.
            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: >-
            Opaque next_cursor from the previous history page, with the same
            memory_id filter.
          in: query
          name: cursor
          schema:
            description: >-
              Opaque next_cursor from the previous history page, with the same
              memory_id filter.
            type: string
        - description: Memory store id (UUID) whose history is being read.
          in: path
          name: memory_store_id
          required: true
          schema:
            description: Memory store id (UUID) whose history is being read.
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsMemoryVersionPage'
          description: >-
            A page of immutable memory history, including the evidence and
            reason for each change.
        '400':
          description: The request was rejected by schema or semantic validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiError'
        '401':
          description: The caller is unauthenticated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiError'
        '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/ManagedAgentsApiError'
        '429':
          headers:
            Retry-After:
              description: Seconds the caller should wait before retrying.
              schema:
                type: string
              style: simple
          description: A rate limit is exhausted. Honor `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiError'
        '500':
          description: An unexpected server-side failure.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiError'
        '502':
          description: The service returned an invalid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorBadGateway'
        '503':
          headers:
            Retry-After:
              description: Seconds the caller should wait before retrying.
              schema:
                type: string
              style: simple
          description: A dependency is unavailable. Retryable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiError'
        '504':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
          description: The service did not respond before the timeout. Retryable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorGatewayTimeout'
components:
  schemas:
    ManagedAgentsMemoryVersionPage:
      description: >-
        A page of immutable memory history, including the evidence and reason
        for each change.
      properties:
        memory_versions:
          description: >-
            Changes to the collection's memories, newest first, without full
            content.
          items:
            $ref: '#/components/schemas/ManagedAgentsMemoryVersion'
          type: array
        next_cursor:
          description: Opaque cursor for the next page of retained memory history.
          type: string
      required:
        - memory_versions
      type: object
      example:
        memory_versions:
          - author_kind: session
            author_principal: example
            author_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            byte_size: 1
            content: example
            content_sha256: example
            created_at: '2026-02-18T09:30:00.000Z'
            evidence_session_ids:
              - example
            memory_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            memory_store_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            memory_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            operation: create
            organization_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            path: example
            rationale: example
            redacted_at: '2026-02-18T09:30:00.000Z'
            redacted_by: example
            reflection_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            status: active
            summary: example
            superseded_by_memory_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        next_cursor: example
    ManagedAgentsApiError:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - analytics
            - analytics_not_ready
            - artifact_fetch_unavailable
            - artifact_generation_mismatch
            - artifact_hash_mismatch
            - artifact_invalid_events
            - artifact_invalid_json
            - artifact_not_allowlisted
            - artifact_size_mismatch
            - atomic_ingest_timeout
            - auth_unavailable
            - automation_event_source_invalid
            - automation_memory_unavailable
            - automation_reference_invalid
            - automation_runs_unconfigured
            - automations_unconfigured
            - bad_gateway
            - built_in_catalog_unavailable
            - built_in_integrations_unconfigured
            - compute_offerings_unavailable
            - conflict
            - content_store_request_canceled
            - content_store_unavailable
            - content_store_upload_timeout
            - credential_encryption_unconfigured
            - delegate_preparation_failed
            - entity_family_not_permitted
            - environment_not_verified
            - evaluation_cancellation_pending
            - evaluation_deletion_pending
            - event_admission_unavailable
            - event_ingress_unavailable
            - event_source_verification_credential_invalid
            - event_sources_unconfigured
            - execution_unconfigured
            - file_quota_exceeded
            - file_storage_unconfigured
            - forbidden
            - gateway_timeout
            - gestalt_unconfigured
            - github_rate_limited
            - github_unavailable
            - handoff_access_invalid
            - handoff_access_unavailable
            - handoff_access_unsupported
            - handoff_capture_unavailable
            - handoff_requires_retest
            - handoff_revoke_unavailable
            - handoff_signal_unavailable
            - idempotency_conflict
            - idempotency_in_progress
            - idempotency_unavailable
            - ingest_policy_changed
            - ingest_policy_not_found
            - ingest_policy_revoked
            - integrations_unconfigured
            - internal_error
            - invalid_json
            - invalid_pull_request_review_result
            - invalid_request
            - invalid_scope
            - invariant_violation
            - live_fleet_unconfigured
            - managed_agents_unavailable
            - missing_dependency
            - model_gateway_metadata_missing
            - model_gateway_unconfigured
            - model_gateway_unreachable
            - mutation_transaction_budget_exceeded
            - not_found
            - page_token_expired
            - payload_too_large
            - persistence_busy
            - precondition_failed
            - precondition_required
            - provider_registration_unsupported
            - provider_selection_unsupported
            - rate_limit_exceeded
            - rate_limited
            - repository_automation_unconfigured
            - request_too_large
            - reserved_source_type
            - revision_conflict
            - run_log_store_unavailable
            - runner_image_resolution_failed
            - sandbox_provider_disabled
            - service_unavailable
            - session_analyst_busy
            - session_analyst_model_unavailable
            - session_analyst_unconfigured
            - session_start_admission_unavailable
            - session_start_not_admitted
            - setup_fallback_environment_unsafe
            - setup_run_finished
            - setup_run_in_progress
            - setup_run_limit
            - setup_run_not_started
            - setup_runs_unavailable
            - skill_storage_unconfigured
            - slack_channels_rejected
            - slack_channels_unavailable
            - slack_channels_unconfigured
            - slack_connection_malformed
            - slack_event_intake_unavailable
            - slack_installation_mismatch
            - slack_missing_scope
            - slack_rate_limited
            - slack_reapproval_required
            - source_ownership_mismatch
            - source_revision_conflict
            - spanner_unavailable
            - streaming_unsupported
            - submission_transaction_budget_exceeded
            - task_version_number_conflict
            - team_board_unconfigured
            - too_many_streams
            - unauthorized
            - unsupported_media_type
            - vault_creation_retired
            - version_content_conflict
            - webhook_delivery_too_large
            - workspace_boundary_denied
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsMemoryVersion:
      description: >-
        One immutable change to a memory. Versions belong to the store rather
        than the memory, so the audit trail survives the memory being deleted.
      properties:
        author_kind:
          description: Who wrote this version.
          enum:
            - session
            - api
            - reflection
            - admin
          type: string
        author_principal:
          description: Caller identity that wrote this version, when an API caller did.
          type: string
        author_session_id:
          description: Session that wrote this version, when a session did.
          type: string
        byte_size:
          description: Size of the content at this version in bytes.
          format: int64
          type: integer
        content:
          description: >-
            Content as it stood at this version. Empty once redacted, and
            omitted from listings.
          type: string
        content_sha256:
          description: SHA-256 of the content at this version.
          type: string
        created_at:
          description: Server-assigned RFC 3339 timestamp of when this version was written.
          format: date-time
          type: string
        evidence_session_ids:
          description: >-
            Sessions supporting this version, scoped to the same agent and
            organization.
          items:
            type: string
          type: array
        memory_id:
          description: >-
            Memory this version describes. The memory may since have been
            deleted.
          type: string
        memory_store_id:
          description: Store this version belongs to.
          type: string
        memory_version_id:
          description: Server-assigned id of the version.
          type: string
        operation:
          description: What this version records.
          enum:
            - create
            - update
            - rename
            - delete
            - retire
          type: string
        organization_id:
          description: Organization that owns this record.
          type: string
        path:
          description: Path of the memory as it stood at this version.
          type: string
        rationale:
          description: Why this memory was added, changed, merged, or retired.
          type: string
        redacted_at:
          description: >-
            Set when the content was scrubbed for compliance. Author and
            timestamp are preserved.
          format: date-time
          type: string
        redacted_by:
          description: Caller that redacted this version.
          type: string
        reflection_id:
          description: Learning run that produced this version.
          type: string
        status:
          description: Memory lifecycle state after this change.
          enum:
            - active
            - retired
            - superseded
          type: string
        summary:
          description: Summary as it stood at this version.
          type: string
        superseded_by_memory_id:
          description: Surviving memory when this version records a merge.
          type: string
      required:
        - organization_id
        - memory_store_id
        - memory_version_id
        - memory_id
        - path
        - operation
        - author_kind
        - created_at
      type: object
      example:
        author_kind: session
        author_principal: example
        author_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        byte_size: 1
        content: example
        content_sha256: example
        created_at: '2026-02-18T09:30:00.000Z'
        evidence_session_ids:
          - example
        memory_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        memory_store_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        memory_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        operation: create
        organization_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        path: example
        rationale: example
        redacted_at: '2026-02-18T09:30:00.000Z'
        redacted_by: example
        reflection_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        status: active
        summary: example
        superseded_by_memory_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A Recursion API key, created in the console under API keys.

````