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

# Approve Repair Preview

> Approve the commit of a repair's draft PR the member reviewed, then deploy its preview.

This stands in for a repo writer's `/floo preview on`, which floo-hosted
repos have no GitHub accounts to post. It is refused unless the reviewed
commit is still the PR's head, and the preview path trusts the repair branch
only at that commit; a later push needs its own review and approval.



## OpenAPI

````yaml https://api.getfloo.com/openapi.json post /v1/apps/{app_id}/reparo/events/{event_id}/approve
openapi: 3.1.0
info:
  title: floo API
  version: 0.1.0
servers:
  - url: https://api.getfloo.com
security: []
paths:
  /v1/apps/{app_id}/reparo/events/{event_id}/approve:
    post:
      tags:
        - reparo
      summary: Approve Repair Preview
      description: >-
        Approve the commit of a repair's draft PR the member reviewed, then
        deploy its preview.


        This stands in for a repo writer's `/floo preview on`, which floo-hosted

        repos have no GitHub accounts to post. It is refused unless the reviewed

        commit is still the PR's head, and the preview path trusts the repair
        branch

        only at that commit; a later push needs its own review and approval.
      operationId: reparo_approve_repair_preview
      parameters:
        - name: event_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Event Id
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: App Id
        - $ref: '#/components/parameters/X-Floo-Org-Id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApproveRepairRequest'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReparoEventResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  parameters:
    X-Floo-Org-Id:
      name: X-Floo-Org-Id
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: Organization to act in; defaults to the one joined most recently.
  schemas:
    ApproveRepairRequest:
      properties:
        commit_sha:
          type: string
          pattern: ^[0-9a-f]{40}$
          title: Commit Sha
      additionalProperties: false
      type: object
      required:
        - commit_sha
      title: ApproveRepairRequest
      description: >-
        The commit of a repair's PR the member reviewed; only that commit is
        approved.
    ReparoEventResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        app_id:
          type: string
          format: uuid
          title: App Id
        deploy_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Deploy Id
        error_fingerprint:
          type: string
          title: Error Fingerprint
        error_message:
          type: string
          title: Error Message
        stack_trace:
          anyOf:
            - type: string
            - type: 'null'
          title: Stack Trace
        status:
          $ref: '#/components/schemas/ReparoEventStatus'
        webhook_response_status:
          anyOf:
            - type: integer
            - type: 'null'
          title: Webhook Response Status
        resolved_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Resolved At
        repair_phase:
          anyOf:
            - $ref: '#/components/schemas/ReparoRepairPhase'
            - type: 'null'
        repair_pr_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Repair Pr Url
        repair_failure_reason:
          anyOf:
            - $ref: '#/components/schemas/ReparoRepairFailure'
            - type: 'null'
        repair_merged_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Repair Merged At
        repair_preview_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Repair Preview Url
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
        - id
        - app_id
        - deploy_id
        - error_fingerprint
        - error_message
        - stack_trace
        - status
        - webhook_response_status
        - resolved_at
        - repair_phase
        - repair_pr_url
        - repair_failure_reason
        - repair_merged_at
        - repair_preview_url
        - created_at
        - updated_at
      title: ReparoEventResponse
      description: Response for a single Reparo event.
    ErrorResponse:
      properties:
        detail:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - detail
      title: ErrorResponse
      description: Body of every error response except request validation (422).
    ReparoEventStatus:
      type: string
      enum:
        - triggered
        - in_progress
        - succeeded
        - failed
        - skipped
      title: ReparoEventStatus
      description: |-
        Lifecycle status of a Reparo event.

        `triggered`   — the event was created and is queued for delivery
        `in_progress` — webhook delivery is in flight (or being retried)
        `succeeded`   — webhook responded 2xx; downstream agent has acked
        `failed`      — permanent delivery failure (after retries)
        `skipped`     — matched a rule but suppressed (cooldown, rate limit)
    ReparoRepairPhase:
      type: string
      enum:
        - pending
        - starting
        - running
        - verifying
        - succeeded
        - recommended
        - failed
      title: ReparoRepairPhase
      description: >-
        Where an event's repair run stands; NULL on events that never got one.


        `pending`   — a run is owed: the event qualified, the build is not
        submitted yet

        `starting`  — bounded, and its build may be submitted; its agent may
        call the gateway

        `running`   — the build is submitted and recorded; its agent may call
        the gateway

        `verifying` — its draft PR is open and waits for a writer to approve its
        preview;
                      the agent is done, so the gateway no longer serves it
        `succeeded` — a fix PR is open (`repair_pr_url`)

        `recommended` — a `recommend` mode run left a fix and a reproduction for
        a
                      person to apply; floo opened no PR and verified nothing
        `failed`    — the run ended without a PR or recommendation
        (`repair_failure_reason`)
    ReparoRepairFailure:
      type: string
      enum:
        - repair_off
        - no_source
        - spend_blocked
        - budget
        - deadline
        - build_failed
        - no_fix
        - not_verified
        - github_refused
      title: ReparoRepairFailure
      description: Why a repair run ended without a PR.
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      additionalProperties: true
      type: object
      required:
        - code
        - message
      title: ErrorDetail
      description: Standard error envelope with operation-specific JSON context.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A `floo_` API key.

````

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