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

# Readiness

> Readiness probe — checks database and Redis connectivity.

Manages its own session (not via Depends(get_db)) to avoid the
auto-commit teardown path turning a 503 into a 500 when the DB
is unreachable.

DB failure or Redis ``disabled`` (manager never initialized) triggers 503.
Redis ``degraded`` (manager exists, ping failed) stays 200 — the redis-py
client auto-reconnects on the next operation, but a worker stuck in
``disabled`` has no in-process recovery path and must be replaced.



## OpenAPI

````yaml /api/openapi.public.json get /v1/readiness
openapi: 3.1.0
info:
  title: Runflow API
  version: 0.1.0
  description: >-
    Public Runflow API. Run AI image and video models, manage media, inspect run
    history, and configure webhooks. Auth: HTTP Bearer.


    This document is the customer integration surface only. Admin and internal
    operations plus generic system reference-data tables are intentionally
    omitted.
servers:
  - url: https://api.runflow.io
    description: Production
security:
  - HTTPBearer: []
tags:
  - name: Models
    description: >-
      Browse the model catalog and dispatch model runs. The primary surface for
      running AI image and video generation.
  - name: Runs
    description: >-
      Inspect, cancel, and re-run model executions. Fetch logs, node-runs, and
      callback delivery history.
  - name: Media
    description: >-
      Upload images and videos as inputs. Organize assets into folders.
      Three-step presigned upload flow for large files.
  - name: Batches
    description: >-
      Run a model on multiple inputs in one request. Includes per-item status
      and a single callback when the batch completes.
  - name: Evaluations
    description: >-
      Submit an image generated anywhere for automated quality evaluation, then
      read a pass verdict, a 0-1 score, and structured issues. No Runflow run
      required.
  - name: Webhooks
    description: >-
      Subscribe to platform events. Inspect delivery history, redeliver failed
      callbacks, manage signing secrets.
  - name: Account
    description: Read your account identity and credit balance.
  - name: Status
    description: Health and readiness probes for the API.
paths:
  /v1/readiness:
    get:
      tags:
        - Status
      summary: Readiness
      description: >-
        Readiness probe — checks database and Redis connectivity.


        Manages its own session (not via Depends(get_db)) to avoid the

        auto-commit teardown path turning a 503 into a 500 when the DB

        is unreachable.


        DB failure or Redis ``disabled`` (manager never initialized) triggers
        503.

        Redis ``degraded`` (manager exists, ping failed) stays 200 — the
        redis-py

        client auto-reconnects on the next operation, but a worker stuck in

        ``disabled`` has no in-process recovery path and must be replaced.
      operationId: getReadiness
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Readiness V1 Readiness Get
components:
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````