> ## 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.

# Undo a prior invalidate.

> Revert an invalidated Memory back to current. Optimistic-locked via `expected_version`.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/sdk/revalidate
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/sdk/revalidate:
    post:
      tags:
        - memory
      summary: Undo a prior invalidate.
      description: >-
        Revert an invalidated Memory back to current. Optimistic-locked via
        `expected_version`.
      operationId: revalidate-memory
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RevalidateRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemoryOutputEnvelope'
        '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:
    RevalidateRequest:
      type: object
      properties:
        memory_id:
          type: string
        expected_version:
          type: integer
      required:
        - memory_id
        - expected_version
      additionalProperties: false
    MemoryOutputEnvelope:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/MemoryOutput'
        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
    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
    Meta:
      type: object
      properties:
        requestId:
          type: string
        timestamp:
          type: string
          format: date-time
        pagination:
          $ref: '#/components/schemas/PaginationMeta'
      required:
        - requestId
        - timestamp
      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.
    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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: rl_ API key

````