> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Replay an orphan-response case

> Puts the frame one `orphan_response` case retained back through the live inbound path — decrypt, verify, process — exactly as a delivery runs it. It is the way back for a frame parked past the backout threshold, for instance during a BACEN key rotation, once the cause is gone. The answer is recorded at the instant the rail received the frame it parked, never at the replay.

The case closes only when the frame was processed, as `closed_by_operator`, with an `operator_case_closure` evidence record. A frame the inbound path refuses again answers `422`, is never parked a second time, and leaves the case open with the reason in the listing's `summary.error`.

Idempotent: a case that is no longer open answers its recorded closure and processes nothing. One frame per request; nothing is sent to BACEN beyond what processing the frame itself produces. `503` when this deployment runs no inbound path to replay through.



## OpenAPI

````yaml /en/openapi/v3-current/src.yaml post /v1/src/operator/orphan-responses/{caseId}/replay
openapi: 3.1.0
info:
  description: >-
    API for Lerian SRC, which sends your institution's restriction consultations
    to BACEN's BC Protege+ and keeps the evidence of each consultation.
  title: Lerian SRC API
  version: 1.1.2
servers:
  - url: https://api.example.com
    description: Replace the example host with your deployment's address.
security:
  - m2m: []
tags:
  - description: >-
      Asynchronous restriction consultations (accept → pending →
      completed/failed).
    name: consultation
  - description: >-
      Client-decision records (exceptional proceed, refusal explanation) —
      single-purpose, write-once.
    name: decision
  - description: Regulatory evidence trail — search, reconstruction, chained correction.
    name: evidence
  - description: Aggregated numeric view per institution.
    name: dashboard
  - description: Status of the institution's regulatory credential.
    name: credential
  - description: >-
      Operator cases — the backlog `openOperatorCases` counts, and the act that
      closes one.
    name: operator
paths:
  /v1/src/operator/orphan-responses/{caseId}/replay:
    post:
      tags:
        - operator
      summary: Replay an orphan-response case
      description: >-
        Puts the frame one `orphan_response` case retained back through the live
        inbound path — decrypt, verify, process — exactly as a delivery runs it.
        It is the way back for a frame parked past the backout threshold, for
        instance during a BACEN key rotation, once the cause is gone. The answer
        is recorded at the instant the rail received the frame it parked, never
        at the replay.


        The case closes only when the frame was processed, as
        `closed_by_operator`, with an `operator_case_closure` evidence record. A
        frame the inbound path refuses again answers `422`, is never parked a
        second time, and leaves the case open with the reason in the listing's
        `summary.error`.


        Idempotent: a case that is no longer open answers its recorded closure
        and processes nothing. One frame per request; nothing is sent to BACEN
        beyond what processing the frame itself produces. `503` when this
        deployment runs no inbound path to replay through.
      operationId: replayOrphanResponseCase
      parameters:
        - description: The orphan-response case whose retained frame is replayed.
          in: path
          name: caseId
          required: true
          schema:
            description: The orphan-response case whose retained frame is replayed.
            format: uuid
            type: string
        - description: Optional correlation id (UUID) propagated through logs/traces.
          in: header
          name: X-Request-ID
          schema:
            description: Optional correlation id (UUID) propagated through logs/traces.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperatorCaseClosedBody'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Bad Request
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Unprocessable Entity
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Service Unavailable
      security:
        - m2m:
            - src:operator:close
components:
  schemas:
    OperatorCaseClosedBody:
      additionalProperties: false
      properties:
        caseId:
          description: The operator case that was closed.
          type: string
        closedAt:
          description: When the closure was recorded (UTC).
          format: date-time
          type: string
        resolution:
          description: 'The resolution written to the case: closed_by_operator.'
          type: string
      required:
        - caseId
        - resolution
        - closedAt
      type: object
    ProblemDetails:
      additionalProperties: false
      properties:
        code:
          type: string
        correlationId:
          examples:
            - req-7a3f9c2e
          type: string
        detail:
          examples:
            - check digits are invalid for the declared documentType
          type: string
        details:
          additionalProperties: {}
          type: object
        instance:
          examples:
            - /v1/src/consultations
          type: string
        status:
          examples:
            - 400
          format: int64
          type: integer
        title:
          examples:
            - Bad Request
          type: string
        traceId:
          examples:
            - a1b2c3d4
          type: string
        type:
          type: string
        violations:
          items:
            $ref: '#/components/schemas/Violation'
          type:
            - array
            - 'null'
      required:
        - type
        - title
        - status
        - detail
        - instance
        - traceId
        - correlationId
        - violations
      type: object
    Violation:
      additionalProperties: false
      properties:
        code:
          type: string
        field:
          examples:
            - document
          type: string
        reason:
          examples:
            - check digits are invalid for the declared documentType
          type: string
      required:
        - field
        - reason
      type: object
  securitySchemes:
    m2m:
      flows:
        clientCredentials:
          scopes:
            src:consultation:read: Read/list consultations
            src:consultation:write: Create restriction consultations
            src:credential:read: Read regulatory-credential status
            src:dashboard:read: Read the aggregated numeric dashboard
            src:decision:write: >-
              File the institution's record against a consultation — exceptional
              proceed (§1º) or refusal explanation (§2º)
            src:evidence:correct: Append a chained correction to an evidence trail
            src:evidence:read: Search and reconstruct the evidence trail
            src:operator:close: >-
              Close an open operator case so it leaves the openOperatorCases
              backlog
            src:operator:read: List the operator cases
          tokenUrl: https://access-manager.example.com/v1/login/oauth/access_token
      type: oauth2

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.