vippet.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "Visual Pipeline and Platform Evaluation Tool API",
    "description": "API for Visual Pipeline and Platform Evaluation Tool",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "/api/v1"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "tags": [
          "health"
        ],
        "summary": "Health Check",
        "description": "**Health check endpoint for Docker healthcheck.**\n\n## Operation\nReturns `healthy=true` as long as the application is not in shutdown state.\nThis allows the container to remain healthy during initialization.\n\n## Parameters\n- **Path/Query parameters:** None\n\n## Response Format\n\n### 200 OK\n**HealthResponse** with:\n- `healthy` - `true` if application is healthy (not shutdown)\n\n## Conditions\n\n### \u2705 Success\n- Application is running (not in shutdown state)\n\n## Example Response\n\n```json\n{\n  \"healthy\": true\n}\n```",
        "operationId": "get_health",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthResponse"
                }
              }
            }
          }
        }
      }
    },
    "/status": {
      "get": {
        "tags": [
          "health"
        ],
        "summary": "Application Status",
        "description": "**Detailed status endpoint for monitoring initialization progress.**\n\n## Operation\nReturns the current application status, including initialization state,\nprogress messages, and readiness for serving API requests.\n\n## Parameters\n- **Path/Query parameters:** None\n\n## Response Format\n\n### 200 OK\n**StatusResponse** with:\n- `status` - Current application status (`starting`, `initializing`, `ready`, `shutdown`)\n- `message` - Optional message describing current activity\n- `ready` - `true` if application is ready to serve API requests\n\n## Conditions\n\n### \u2705 Success\n- Application is running and status can be retrieved\n\n## Examples\n\n### Response (During Initialization)\n```json\n{\n  \"status\": \"initializing\",\n  \"message\": \"Loading video metadata...\",\n  \"ready\": false\n}\n```\n\n### Response (When Ready)\n```json\n{\n  \"status\": \"ready\",\n  \"message\": null,\n  \"ready\": true\n}\n```",
        "operationId": "get_status",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StatusResponse"
                }
              }
            }
          }
        }
      }
    },
    "/convert/to-graph": {
      "post": {
        "tags": [
          "convert"
        ],
        "summary": "Convert pipeline description to pipeline graphs (both views)",
        "description": "**Convert GStreamer-like pipeline description into structured pipeline graphs.**\n\n## Operation\nParses the textual pipeline description, validates it, and builds both an advanced view\n(with all technical elements) and a simple view (with only meaningful elements).\n\n1. Parse pipeline description string\n2. Validate syntax and resolve references (models, videos)\n3. Build advanced graph with all elements including technical plumbing\n4. Generate simplified view with only visible elements (sources, inference, sinks)\n5. Return both graph representations\n\n## Request Body\n**`PipelineDescription`** with:\n- `pipeline_description` *(required)* - GStreamer-like pipeline string\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `PipelineGraphResponse` with both `pipeline_graph` and `pipeline_graph_simple` |\n| 400 | `MessageResponse` - Invalid or unparsable pipeline description |\n| 500 | `MessageResponse` - Unexpected internal error |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline description is syntactically correct\n- All referenced models and input videos can be resolved\n- Description maps to non-empty, acyclic graph with at least one start node\n- Simple view can be generated from advanced view\n\n### \u274c Failure\n- Invalid or unparsable pipeline description (syntax error, unsupported token) \u2192 400\n- Missing required data, unknown model/video \u2192 400\n- Unexpected internal error \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"pipeline_description\": \"videotestsrc ! videoconvert ! autovideosink\"\n}\n```\n\n### Success Response (200)\n```json\n{\n  \"pipeline_graph\": {\n    \"nodes\": [\n      {\"id\": \"0\", \"type\": \"videotestsrc\", \"data\": {}},\n      {\"id\": \"1\", \"type\": \"videoconvert\", \"data\": {}},\n      {\"id\": \"2\", \"type\": \"autovideosink\", \"data\": {}}\n    ],\n    \"edges\": [\n      {\"id\": \"0\", \"source\": \"0\", \"target\": \"1\"},\n      {\"id\": \"1\", \"source\": \"1\", \"target\": \"2\"}\n    ]\n  },\n  \"pipeline_graph_simple\": {\n    \"nodes\": [\n      {\"id\": \"0\", \"type\": \"videotestsrc\", \"data\": {}},\n      {\"id\": \"2\", \"type\": \"autovideosink\", \"data\": {}}\n    ],\n    \"edges\": [\n      {\"id\": \"0\", \"source\": \"0\", \"target\": \"2\"}\n    ]\n  }\n}\n```\n\n### Error Response (400)\n```json\n{\n  \"message\": \"Invalid pipeline description: Unrecognized token in pipeline description: '??'\"\n}\n```",
        "operationId": "to_graph",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineDescription"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Conversion successful",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PipelineGraphResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pipeline description",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/convert/to-description": {
      "post": {
        "tags": [
          "convert"
        ],
        "summary": "Convert pipeline graph to pipeline description",
        "description": "**Convert structured pipeline graph into GStreamer-like pipeline description string.**\n\n## Operation\nValidates the input graph (advanced view) and serializes its nodes and edges\nback into a single pipeline description line.\n\n1. Validate input graph structure\n2. Check for start nodes and acyclic structure\n3. Map model and video display names back to real paths\n4. Serialize nodes and edges into pipeline description string\n\n> **Note:** The input should be an advanced view graph containing all technical elements.\n\n## Request Body\n**`PipelineGraph`** with:\n- `nodes` *(required)* - Array of pipeline nodes (advanced view expected)\n- `edges` *(required)* - Array of edges connecting the nodes\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `PipelineDescription` with textual pipeline description |\n| 400 | `MessageResponse` - Invalid graph structure |\n| 500 | `MessageResponse` - Unexpected internal error |\n\n## Conditions\n\n### \u2705 Success\n- Graph is non-empty and contains at least one start node\n- Graph is a valid directed acyclic graph (no unresolved references, no circular graph)\n- All model and input video display names can be mapped back to real paths\n\n### \u274c Failure\n- Invalid graph structure (no start nodes, circular graph, missing nodes) \u2192 400\n- Unknown model/video or empty graph \u2192 400\n- Unexpected internal error \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"nodes\": [\n    {\"id\": \"0\", \"type\": \"videotestsrc\", \"data\": {}},\n    {\"id\": \"1\", \"type\": \"videoconvert\", \"data\": {}},\n    {\"id\": \"2\", \"type\": \"autovideosink\", \"data\": {}}\n  ],\n  \"edges\": [\n    {\"id\": \"0\", \"source\": \"0\", \"target\": \"1\"},\n    {\"id\": \"1\", \"source\": \"1\", \"target\": \"2\"}\n  ]\n}\n```\n\n### Success Response (200)\n```json\n{\n  \"pipeline_description\": \"videotestsrc ! videoconvert ! autovideosink\"\n}\n```\n\n### Error Response (400)\n```json\n{\n  \"message\": \"Invalid graph: circular graph detected or no start nodes found\"\n}\n```",
        "operationId": "to_description",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineGraph"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Conversion successful",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PipelineDescription"
                }
              }
            }
          },
          "400": {
            "description": "Invalid graph",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/devices": {
      "get": {
        "tags": [
          "devices"
        ],
        "summary": "List available inference devices",
        "description": "**Return all devices discovered by the OpenVINO runtime.**\n\n## Operation\nDiscovers CPU, GPU, and NPU devices available in the system and exposes\nthem in a simplified, API-friendly format.\n\n1. Initialize OpenVINO Core\n2. Discover all available inference devices\n3. Extract device properties and metadata\n4. Return formatted device list\n\n## Parameters\n- **Path/Query parameters:** None\n\n## Response Format\n\n### 200 OK\nJSON array of Device objects.\n\n**Each device includes:**\n- `device_name` - Short identifier used by runtime (e.g., `\"CPU\"`, `\"GPU\"`, `\"GPU.0\"`, `\"NPU\"`)\n- `full_device_name` - Human-readable name (e.g., CPU/GPU marketing name)\n- `device_type` - `INTEGRATED` or `DISCRETE`\n- `device_family` - `CPU`, `GPU`, or `NPU`\n- `gpu_id` - Integer index for GPU devices (when applicable), otherwise `null`\n\n## Conditions\n\n### \u2705 Success\n- OpenVINO Core initializes correctly\n- At least zero devices are returned (empty list is valid)\n\n### \u274c Failure\n- Unhandled exception during device discovery \u2192 500\n- OpenVINO cannot be initialized \u2192 500\n\n## Example Response\n\n```json\n[\n  {\n    \"device_name\": \"CPU\",\n    \"full_device_name\": \"Intel(R) Core(TM) Ultra 7 155H\",\n    \"device_type\": \"INTEGRATED\",\n    \"device_family\": \"CPU\",\n    \"gpu_id\": null\n  },\n  {\n    \"device_name\": \"GPU.0\",\n    \"full_device_name\": \"Intel(R) Arc(TM) Graphics (iGPU) (GPU.0)\",\n    \"device_type\": \"INTEGRATED\",\n    \"device_family\": \"GPU\",\n    \"gpu_id\": 0\n  }\n]\n```",
        "operationId": "get_devices",
        "responses": {
          "200": {
            "description": "List of devices successfully retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Device"
                  },
                  "type": "array",
                  "title": "Response 200 Get Devices"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error when discovering devices.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/performance/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "List all performance test jobs",
        "description": "**List statuses of all performance test jobs.**\n\n## Operation\n\nReads current state and metrics for every performance test job created via the performance test API.\n\n## Parameters\n\nNone\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 200  | JSON array of PerformanceJobStatus objects |\n| 500  | Unexpected internal error |\n\n## Conditions\n\n### \u2705 Success\n- TestsManager is initialized\n- Zero or more jobs may be present\n\n### \u274c Failure\n- Internal errors \u2192 500\n\n## Example Response\n\n```json\n[\n  {\n    \"id\": \"job123\",\n    \"start_time\": 1715000000000,\n    \"elapsed_time\": 120000,\n    \"state\": \"RUNNING\",\n    \"details\": [],\n    \"total_fps\": 480.0,\n    \"per_stream_fps\": 30.0,\n    \"total_streams\": 16,\n    \"streams_per_pipeline\": [\n      {\"id\": \"pipeline-1\", \"streams\": 8},\n      {\"id\": \"pipeline-2\", \"streams\": 8}\n    ],\n    \"video_output_paths\": {\n      \"pipeline-1\": [\"/outputs/job123-p1-0.mp4\"]\n    }\n  }\n]\n```",
        "operationId": "get_performance_statuses",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PerformanceJobStatus"
                  },
                  "type": "array",
                  "title": "Response Get Performance Statuses"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/performance/{job_id}/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get performance test job status",
        "description": "**Get detailed status of a single performance test job.**\n\n## Operation\n\nRetrieves current state, timings, FPS metrics, and output paths for a specific performance test job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the performance job to inspect\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | PerformanceJobStatus with current state, timings, FPS and output paths |\n| 404  | Job with given id does not exist |\n| 500  | Unexpected internal error |\n\n## Conditions\n\n### \u2705 Success\n- Job with given id exists in TestsManager\n\n### \u274c Failure\n- Unknown job id \u2192 404\n- Unexpected job status type \u2192 500\n\n## Examples\n\nSuccess (200):\n```json\n{\n  \"id\": \"job123\",\n  \"start_time\": 1715000000000,\n  \"elapsed_time\": 60000,\n  \"state\": \"COMPLETED\",\n  \"details\": [\"Pipeline completed successfully\"],\n  \"total_fps\": 480.0,\n  \"per_stream_fps\": 30.0,\n  \"total_streams\": 16,\n  \"streams_per_pipeline\": [\n    {\"id\": \"pipeline-1\", \"streams\": 8},\n    {\"id\": \"pipeline-2\", \"streams\": 8}\n  ],\n  \"video_output_paths\": {\n    \"pipeline-1\": [\"/outputs/job123-p1-0.mp4\"]\n  }\n}\n```\n\nError (404):\n```json\n{\n  \"message\": \"Performance job job123 not found\"\n}\n```\n\nError (500):\n```json\n{\n  \"message\": \"Unexpected job status type for job job123\"\n}\n```",
        "operationId": "get_performance_job_status",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceJobStatus"
                }
              }
            }
          },
          "404": {
            "description": "Job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/performance/{job_id}": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get performance test job summary",
        "description": "**Get a short summary of a performance test job.**\n\n## Operation\n\nRetrieves the job id and original PerformanceTestSpec for a specific job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the performance job created earlier\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | PerformanceJobSummary with job id and original request |\n| 404  | Job does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Job exists in TestsManager\n\n### \u274c Failure\n- Unknown job id \u2192 404\n\n## Example Response\n\n```json\n{\n  \"id\": \"job123\",\n  \"request\": {\n    \"pipeline_performance_specs\": [\n      {\"id\": \"pipeline-1\", \"streams\": 8}\n    ],\n    \"video_output\": {\n      \"enabled\": false,\n      \"encoder_device\": {\"device_name\": \"GPU\", \"gpu_id\": 0}\n    }\n  }\n}\n```",
        "operationId": "get_performance_job_summary",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceJobSummary"
                }
              }
            }
          },
          "404": {
            "description": "Job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "jobs"
        ],
        "summary": "Stop a running performance test job",
        "description": "**Stop a running performance test job.**\n\n## Operation\n\nRequests cancellation of a RUNNING performance test job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the performance test job to stop\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | Job was RUNNING and cancellation was successfully requested |\n| 404  | Job id is unknown or there is no active runner |\n| 409  | Job exists but is not in RUNNING state |\n| 500  | Unexpected error occurs while stopping |\n\n## Conditions\n\n### \u2705 Success\n- Job exists and state == RUNNING\n- TestsManager.stop_job() returns success\n\n### \u274c Failure\n- TestsManager.stop_job() returns \"not found\" / \"no active runner\" \u2192 404\n- TestsManager.stop_job() returns \"not running\" \u2192 409\n- Any other error from stop_job() \u2192 500\n\n## Examples\n\nSuccess (200):\n```json\n{\n  \"message\": \"Job job123 stopped\"\n}\n```\n\nConflict (409):\n```json\n{\n  \"message\": \"Job job123 is not running (state: COMPLETED)\"\n}\n```",
        "operationId": "stop_performance_test_job",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Performance test job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "409": {
            "description": "Performance test job not running",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/performance/{job_id}/metadata/{pipeline_id}/{file_index}": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get metadata snapshot for a specific pipeline stream",
        "description": "**Return the most recent metadata records for a specific pipeline stream.**\n\n## Operation\n\nReturns a snapshot of up to ``limit`` JSON records read directly from disk,\nwritten by the ``gvametapublish`` element identified by *pipeline_id* and\nthe per-pipeline *file_index*.  Records remain available after the job\ncompletes.\n\n## Path Parameters\n\n- `job_id`: Identifier of the performance job\n- `pipeline_id`: Pipeline identifier\n- `file_index`: Zero-based index of the metadata file within that pipeline\n\n## Query Parameters\n\n- `limit` *(optional, default 100, max 1000)*: Maximum number of records to return\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | JSON array of metadata records (may be empty) |\n| 404  | Job id, pipeline id, or file index is unknown |",
        "operationId": "get_performance_job_metadata_snapshot",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          },
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "file_index",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "File Index"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 1000,
              "minimum": 1,
              "default": 100,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of metadata records for the specified pipeline stream",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Job, pipeline, or file index not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/performance/{job_id}/metadata/{pipeline_id}/{file_index}/stream": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Stream metadata from a running performance test job via SSE",
        "description": "**Stream live metadata records from gvametapublish via Server-Sent Events.**\n\n## Operation\n\nOpens a persistent HTTP connection and pushes each new JSON record emitted\nby the ``gvametapublish`` GStreamer element as an SSE ``data:`` event.\nThe stream terminates automatically when the pipeline finishes.\nA ``\": keepalive\"`` comment is sent every 30 s to prevent proxy timeouts.\n\n## Path Parameters\n\n- `job_id`: Identifier of the performance job to stream metadata from\n\n## Response Format\n\n``text/event-stream`` \u2014 each event is:\n```\ndata: {<json record>}\n\n\n```\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | SSE stream opened |\n| 404  | Job id is unknown or no metadata is available for this job |",
        "operationId": "stream_performance_job_metadata",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          },
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "file_index",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "File Index"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SSE stream of metadata records",
            "content": {
              "application/json": {
                "schema": {}
              },
              "text/event-stream": {}
            }
          },
          "404": {
            "description": "Job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/density/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "List all density test jobs",
        "description": "**List statuses of all density test jobs.**\n\n## Operation\n\nReads current state and metrics for every density test job.\n\n## Parameters\n\nNone\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 200  | JSON array of DensityJobStatus objects |\n\n## Conditions\n\n### \u2705 Success\n- TestsManager is initialized\n\n## Example Response\n\n```json\n[\n  {\n    \"id\": \"job456\",\n    \"start_time\": 1715000000000,\n    \"elapsed_time\": 45000,\n    \"state\": \"RUNNING\",\n    \"details\": [],\n    \"total_fps\": null,\n    \"per_stream_fps\": 28.5,\n    \"total_streams\": 32,\n    \"streams_per_pipeline\": [\n      {\"id\": \"pipeline-1\", \"streams\": 16},\n      {\"id\": \"pipeline-2\", \"streams\": 16}\n    ],\n    \"video_output_paths\": {\n      \"pipeline-1\": [\"/outputs/job456-p1-0.mp4\"]\n    }\n  }\n]\n```",
        "operationId": "get_density_statuses",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DensityJobStatus"
                  },
                  "type": "array",
                  "title": "Response Get Density Statuses"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/density/{job_id}/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get density test job status",
        "description": "**Get detailed status of a single density test job.**\n\n## Operation\n\nRetrieves current state, timings, and FPS metrics for a specific density test job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the density job to inspect\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | DensityJobStatus for the given job |\n| 404  | Job id is unknown |\n| 500  | Unexpected internal error |\n\n## Conditions\n\n### \u2705 Success\n- Job with given id exists in TestsManager\n\n### \u274c Failure\n- Unknown job id \u2192 404\n- Unexpected job status type \u2192 500\n\n## Examples\n\nError (404):\n```json\n{\n  \"message\": \"Density job job456 not found\"\n}\n```\n\nError (500):\n```json\n{\n  \"message\": \"Unexpected job status type for job job456\"\n}\n```",
        "operationId": "get_density_job_status",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DensityJobStatus"
                }
              }
            }
          },
          "404": {
            "description": "Job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/tests/density/{job_id}": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get density test job summary",
        "description": "**Get a short summary of a density test job.**\n\n## Operation\n\nRetrieves the job id and original DensityTestSpec for a specific job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the density job created earlier\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | DensityJobSummary with job id and original request |\n| 404  | Job does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Job exists in TestsManager\n\n### \u274c Failure\n- Unknown job id \u2192 404\n\n## Example Response\n\n```json\n{\n  \"id\": \"job456\",\n  \"request\": {\n    \"fps_floor\": 30,\n    \"pipeline_density_specs\": [\n      {\"id\": \"pipeline-1\", \"stream_rate\": 50},\n      {\"id\": \"pipeline-2\", \"stream_rate\": 50}\n    ],\n    \"video_output\": {\n      \"enabled\": false,\n      \"encoder_device\": {\"device_name\": \"GPU\", \"gpu_id\": 0}\n    }\n  }\n}\n```",
        "operationId": "get_density_job_summary",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DensityJobSummary"
                }
              }
            }
          },
          "404": {
            "description": "Job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "jobs"
        ],
        "summary": "Stop a running density test job",
        "description": "**Stop a running density test job.**\n\n## Operation\n\nRequests cancellation of a RUNNING density test job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the density test job to stop\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | Job was RUNNING and cancellation was successfully requested |\n| 404  | Job id is unknown or there is no active runner |\n| 409  | Job exists but is not RUNNING |\n| 500  | Unexpected error |\n\n## Conditions\n\nSame status mapping logic as stop_performance_test_job.",
        "operationId": "stop_density_test_job",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Density test job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "409": {
            "description": "Density test job not running",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/optimization/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "List all optimization jobs",
        "description": "**List statuses of all optimization jobs.**\n\n## Operation\n\nReads current state and results for every optimization job.\n\n## Parameters\n\nNone\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 200  | JSON array of OptimizationJobStatus objects |\n\n## Conditions\n\n### \u2705 Success\n- OptimizationManager is initialized\n\n## Example Response\n\n```json\n[\n  {\n    \"id\": \"opt789\",\n    \"type\": \"OPTIMIZE\",\n    \"start_time\": 1715000000000,\n    \"elapsed_time\": 20000,\n    \"state\": \"RUNNING\",\n    \"details\": [],\n    \"total_fps\": null,\n    \"original_pipeline_graph\": {\"nodes\": [], \"edges\": []},\n    \"optimized_pipeline_graph\": null,\n    \"original_pipeline_description\": \"videotestsrc ! fakesink\",\n    \"optimized_pipeline_description\": null\n  }\n]\n```",
        "operationId": "get_optimization_statuses",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/OptimizationJobStatus"
                  },
                  "type": "array",
                  "title": "Response Get Optimization Statuses"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/optimization/{job_id}": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get optimization job summary",
        "description": "**Get a short summary of an optimization job.**\n\n## Operation\n\nRetrieves the job id and original optimization request for a specific job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the optimization job created earlier\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | OptimizationJobSummary with job id and original request |\n| 404  | Job does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Job exists in OptimizationManager\n\n### \u274c Failure\n- Unknown job id \u2192 404\n\n## Error Example\n\n```json\n{\n  \"message\": \"Optimization job opt789 not found\"\n}\n```",
        "operationId": "get_optimization_job_summary",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptimizationJobSummary"
                }
              }
            }
          },
          "404": {
            "description": "Optimization job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/optimization/{job_id}/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get optimization job status",
        "description": "**Get detailed status of a single optimization job.**\n\n## Operation\n\nRetrieves timings, state, graphs, descriptions and total_fps (for OPTIMIZE) for a specific optimization job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the optimization job to inspect\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | OptimizationJobStatus containing timings, state, graphs and descriptions |\n| 404  | Job does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Job with given id exists in OptimizationManager\n\n### \u274c Failure\n- Unknown job id \u2192 404",
        "operationId": "get_optimization_job_status",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptimizationJobStatus"
                }
              }
            }
          },
          "404": {
            "description": "Optimization job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/validation/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "List all validation jobs",
        "description": "**List statuses of all validation jobs.**\n\n## Operation\n\nReads current state and validation result for all validation jobs.\n\n## Parameters\n\nNone\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 200  | JSON array of ValidationJobStatus objects |\n\n## Conditions\n\n### \u2705 Success\n- ValidationManager is initialized\n\n## Example Response\n\n```json\n[\n  {\n    \"id\": \"val001\",\n    \"start_time\": 1715000000000,\n    \"elapsed_time\": 10000,\n    \"state\": \"RUNNING\",\n    \"details\": [],\n    \"is_valid\": null\n  }\n]\n```",
        "operationId": "get_validation_statuses",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ValidationJobStatus"
                  },
                  "type": "array",
                  "title": "Response Get Validation Statuses"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/validation/{job_id}": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get validation job summary",
        "description": "**Get a short summary of a validation job.**\n\n## Operation\n\nRetrieves the job id and original validation request for a specific job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the validation job created earlier\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | ValidationJobSummary with job id and original request |\n| 404  | Job does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Job exists in ValidationManager\n\n### \u274c Failure\n- Unknown job id \u2192 404",
        "operationId": "get_validation_job_summary",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationJobSummary"
                }
              }
            }
          },
          "404": {
            "description": "Validation job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/validation/{job_id}/status": {
      "get": {
        "tags": [
          "jobs"
        ],
        "summary": "Get validation job status",
        "description": "**Get detailed status of a single validation job.**\n\n## Operation\n\nRetrieves timings, state, is_valid flag and details list for a specific validation job.\n\n## Path Parameters\n\n- `job_id`: Identifier of the validation job to inspect\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200  | ValidationJobStatus with timings, state, is_valid flag and details |\n| 404  | Job does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Job with given id exists in ValidationManager\n\n### \u274c Failure\n- Unknown job id \u2192 404\n\n## Error Example\n\n```json\n{\n  \"message\": \"Validation job val001 not found\"\n}\n```",
        "operationId": "get_validation_job_status",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Job Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationJobStatus"
                }
              }
            }
          },
          "404": {
            "description": "Validation job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/models": {
      "get": {
        "tags": [
          "models"
        ],
        "summary": "List All Models",
        "description": "**List all installed and available models.**\n\n## Operation\nRead the supported models configuration, filter out models that are not\npresent on disk, and expose the remaining models in an API-friendly format.\n\n## Parameters\n- **Path/Query parameters:** None\n\n## Response Format\n\n### 200 OK\nJSON array of Model objects.\n\n**Each model includes:**\n- `name` - Internal model identifier\n- `display_name` - Human-readable model name\n- `category` - Logical model category (`classification`, `detection`) or `null` when type is unknown\n- `precision` - Model precision (e.g., `\"FP32\"`, `\"INT8\"`) if available\n\n## Conditions\n\n### \u2705 Success\n- `supported_models.yaml` is loaded correctly by SupportedModelsManager\n- At least zero models are installed on disk (empty list is valid)\n\n### \u274c Failure\n- If SupportedModelsManager cannot be initialized (e.g., file missing, invalid YAML),\n  the application exits at startup and this endpoint will not be available\n\n## Example Response\n\n```json\n[\n  {\n    \"name\": \"vehicle-detection-0202\",\n    \"display_name\": \"Vehicle Detection\",\n    \"category\": \"detection\",\n    \"precision\": \"FP32\"\n  },\n  {\n    \"name\": \"person-reidentification-0200\",\n    \"display_name\": \"Person Reidentification\",\n    \"category\": \"classification\",\n    \"precision\": \"INT8\"\n  }\n]\n```",
        "operationId": "get_models",
        "responses": {
          "200": {
            "description": "List of all installed and available models",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Model"
                  },
                  "type": "array",
                  "title": "Response Get Models"
                }
              }
            }
          }
        }
      }
    },
    "/pipeline-templates": {
      "get": {
        "tags": [
          "pipeline-templates"
        ],
        "summary": "Get Pipeline Templates",
        "description": "List all available pipeline templates.\n\nOperation:\n    Return all read-only pipeline templates loaded from configuration.\n    Properties that require user-supplied values (e.g. input source URI, model paths)\n    are stored as empty strings. Use templates as a starting point.\n\nPath / query parameters:\n    None.\n\nReturns:\n    200 OK:\n        JSON array of Pipeline objects with ``source=TEMPLATE``.\n        Each pipeline includes:\n        * id, name, description, source, tags\n        * variants (list of Variant objects with graphs and timestamps),\n          all variants have ``read_only=True``\n        * thumbnail (always null for templates)\n        * created_at, modified_at (UTC datetime, serialized as ISO 8601 strings)\n\nSuccess conditions:\n    * PipelineTemplateManager is initialized (even if no templates are loaded,\n      an empty array is returned).\n\nFailure conditions:\n    * Unexpected errors will be returned as 500 Internal Server Error.\n\nResponse example (200):\n    .. code-block:: json\n\n        [\n          {\n            \"id\": \"detect-only\",\n            \"name\": \"Detect Only\",\n            \"description\": \"Template pipeline with a single object detection model.\",\n            \"source\": \"TEMPLATE\",\n            \"tags\": [\"template\", \"detection\"],\n            \"variants\": [\n              {\n                \"id\": \"cpu\",\n                \"name\": \"CPU\",\n                \"read_only\": true,\n                \"pipeline_graph\": {},\n                \"pipeline_graph_simple\": {},\n                \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n                \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n              }\n            ],\n            \"thumbnail\": null,\n            \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n            \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n          }\n        ]",
        "operationId": "get_pipeline_templates",
        "responses": {
          "200": {
            "description": "List of all available pipeline templates",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Pipeline"
                  },
                  "type": "array",
                  "title": "Response 200 Get Pipeline Templates"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/pipeline-templates/{template_id}": {
      "get": {
        "tags": [
          "pipeline-templates"
        ],
        "summary": "Get Pipeline Template",
        "description": "Get a single pipeline template by its ID.\n\nOperation:\n    Look up a template by its unique identifier and return it.\n\nPath / query parameters:\n    template_id: Unique identifier of the template.\n\nReturns:\n    200 OK:\n        Pipeline object with ``source=TEMPLATE``.\n        Includes:\n        * id, name, description, source, tags\n        * variants (list of Variant objects with graphs and timestamps),\n          all variants have ``read_only=True``\n        * thumbnail (always null for templates)\n        * created_at, modified_at (UTC datetime, serialized as ISO 8601 strings)\n    404 Not Found:\n        MessageResponse if a template with the given ID does not exist.\n    500 Internal Server Error:\n        MessageResponse when an unexpected error occurs.\n\nSuccess conditions:\n    * Template with the given ID exists.\n\nFailure conditions:\n    * Template with the given ID does not exist \u2013 404 Not Found.\n    * Unexpected errors will be returned as 500 Internal Server Error.\n\nResponse example (200):\n    .. code-block:: json\n\n        {\n          \"id\": \"detect-only\",\n          \"name\": \"Detect Only\",\n          \"description\": \"Template pipeline with a single object detection model.\",\n          \"source\": \"TEMPLATE\",\n          \"tags\": [\"template\", \"detection\"],\n          \"variants\": [\n            {\n              \"id\": \"cpu\",\n              \"name\": \"CPU\",\n              \"read_only\": true,\n              \"pipeline_graph\": {},\n              \"pipeline_graph_simple\": {},\n              \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n              \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n            }\n          ],\n          \"thumbnail\": null,\n          \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n          \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n        }",
        "operationId": "get_pipeline_template",
        "parameters": [
          {
            "name": "template_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Template Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pipeline"
                }
              }
            }
          },
          "404": {
            "description": "Template not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines": {
      "get": {
        "tags": [
          "pipelines"
        ],
        "summary": "List All Pipelines",
        "description": "**List all pipelines currently registered in the system.**\n\n## Operation\nReturn both predefined pipelines loaded from configuration and\nuser-created pipelines added via this API.\n\n## Parameters\n- **Path/Query parameters:** None\n\n## Response Format\n\n### 200 OK\nJSON array of Pipeline objects with all variants.\n\n**Each pipeline includes:**\n- `id` - Unique pipeline identifier\n- `name` - Pipeline name\n- `description` - Human-readable description\n- `source` - Pipeline source (`PREDEFINED` or `USER_CREATED`)\n- `tags` - List of categorization tags\n- `variants` - List of Variant objects with:\n  - Pipeline graphs and timestamps\n  - `read_only` flag\n- `thumbnail` - Base64-encoded image for PREDEFINED pipelines, `null` otherwise\n  > **Note:** Thumbnail is redacted in logs but returned in full in API response\n- `created_at`, `modified_at` - UTC datetime (ISO 8601 format)\n\n## Conditions\n\n### \u2705 Success\n- PipelineManager is initialized and has pipelines loaded\n\n### \u274c Failure\n- Unexpected errors will be propagated as 500 by FastAPI\n\n## Example Response\n\n```json\n[\n  {\n    \"id\": \"pipeline-a3f5d9e1\",\n    \"name\": \"vehicle-detection\",\n    \"description\": \"Simple vehicle detection pipeline\",\n    \"source\": \"PREDEFINED\",\n    \"tags\": [\"detection\"],\n    \"variants\": [\n      {\n        \"id\": \"variant-1\",\n        \"name\": \"CPU\",\n        \"read_only\": true,\n        \"pipeline_graph\": {...},\n        \"pipeline_graph_simple\": {...},\n        \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n        \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n      }\n    ],\n    \"thumbnail\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...\",\n    \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n    \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n  }\n]\n```",
        "operationId": "get_pipelines",
        "responses": {
          "200": {
            "description": "List of all pipelines including predefined and user-created",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Pipeline"
                  },
                  "type": "array",
                  "title": "Response Get Pipelines"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "pipelines"
        ],
        "summary": "Create Pipeline",
        "description": "**Create a new user-defined pipeline.**\n\n## Operation\n1. Enforce `USER_CREATED` source\n2. Delegate to `PipelineManager.add_pipeline()`\n3. Return generated pipeline ID\n\n## Auto-Generated Fields\nThe backend automatically sets:\n- Pipeline ID (generated from name)\n- Timestamps (`created_at` and `modified_at`)\n- Variant IDs (generated from variant names)\n- Variant `read_only=False` for all variants\n- Pipeline `thumbnail=None` (user-created pipelines)\n\n## Request Body\n**`PipelineDefinition`** with:\n- `name` *(required)* - Non-empty pipeline name\n- `description` *(required)* - Human-readable description\n- `source` *(ignored)* - Forced to `USER_CREATED`\n- `tags` *(optional)* - List of categorization tags\n- `variants` *(required)* - List of `VariantCreate` objects:\n  - `name` - Variant name\n  - `pipeline_graph` - Advanced graph representation\n  - `pipeline_graph_simple` - Simplified graph representation\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 201 | `PipelineCreationResponse` with generated pipeline `id` |\n| 400 | `MessageResponse` - Invalid pipeline definition |\n| 500 | `MessageResponse` - Unexpected error |\n\n## Conditions\n\n### \u2705 Success\n- Valid PipelineDefinition\n- PipelineManager successfully creates pipeline\n\n### \u274c Failure\n- Invalid pipeline definition \u2192 400\n- Unhandled error \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"name\": \"vehicle-detection\",\n  \"description\": \"Simple vehicle detection pipeline\",\n  \"tags\": [\"detection\", \"vehicle\"],\n  \"variants\": [\n    {\n      \"name\": \"CPU\",\n      \"pipeline_graph\": {...},\n      \"pipeline_graph_simple\": {...}\n    }\n  ]\n}\n```\n\n### Success Response (201)\n```json\n{\n  \"id\": \"pipeline-a3f5d9e1\"\n}\n```\n\n### Error Response (400)\n```json\n{\n  \"message\": \"Pipeline name cannot be empty\"\n}\n```",
        "operationId": "create_pipeline",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineDefinition"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Pipeline created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PipelineCreationResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pipeline definition",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/validate": {
      "post": {
        "tags": [
          "pipelines"
        ],
        "summary": "Validate Pipeline",
        "description": "**Start asynchronous validation job for a pipeline graph.**\n\n## Operation\n1. Convert PipelineGraph to GStreamer launch string\n2. Extract validation parameters (e.g., `max-runtime`)\n3. Create validation job and run `gst_runner.py` in background\n4. Return generated job ID\n\n## Request Body\n**`PipelineValidation`** with:\n- `pipeline_graph` *(required)* - Nodes and edges representation\n- `parameters` *(optional)* - Configuration dict, e.g., `{\"max-runtime\": 10}`\n  - **Note:** `max-runtime` must be > 0 for validation mode\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 202 | `ValidationJobResponse` with `job_id` |\n| 400 | `MessageResponse` - Invalid parameters (e.g., `max-runtime` < 1) |\n| 500 | `MessageResponse` - Unexpected error (e.g., graph conversion) |\n\n## Conditions\n\n### \u2705 Success\n- Graph converts to valid launch string\n- Parameters pass ValidationManager checks\n- Background validation job started\n\n### \u274c Failure\n- Parameter validation error \u2192 400\n- Unexpected exception \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"pipeline_graph\": {\n    \"nodes\": [\n      {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"/videos/input.mp4\"}},\n      {\"id\": \"1\", \"type\": \"decodebin\", \"data\": {}},\n      {\"id\": \"2\", \"type\": \"fakesink\", \"data\": {}}\n    ],\n    \"edges\": [\n      {\"id\": \"0\", \"source\": \"0\", \"target\": \"1\"},\n      {\"id\": \"1\", \"source\": \"1\", \"target\": \"2\"}\n    ]\n  },\n  \"parameters\": {\n    \"max-runtime\": 10\n  }\n}\n```\n\n### Success Response (202)\n```json\n{\n  \"job_id\": \"val001\"\n}\n```\n\n### Error Response (400)\n```json\n{\n  \"message\": \"Parameter 'max-runtime' must be greater than or equal to 1.\"\n}\n```",
        "operationId": "validate_pipeline",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineValidation-Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Pipeline validation started",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid validation request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/{pipeline_id}": {
      "get": {
        "tags": [
          "pipelines"
        ],
        "summary": "Get Pipeline by ID",
        "description": "**Get details of a single pipeline by its ID.**\n\n## Operation\nRetrieve the full pipeline definition including all variants,\nmetadata, timestamps, and tags.\n\n## Path Parameters\n- `pipeline_id` - Unique identifier of the pipeline (e.g., `\"pipeline-a3f5d9e1\"`)\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | Complete Pipeline object with all fields |\n| 404 | `MessageResponse` - Pipeline with given ID does not exist |\n| 500 | `MessageResponse` - Unexpected error in manager layer |\n\n## Response Fields (200)\n- `id`, `name`, `description`, `source`, `tags`\n- `variants` - Each with `pipeline_graph`, `pipeline_graph_simple`, and timestamps\n- `thumbnail` - Base64-encoded image for PREDEFINED pipelines, `null` otherwise\n  > **Note:** Thumbnail is redacted in logs but returned in full in API response\n- `created_at`, `modified_at` - UTC datetime (ISO 8601 format, set by backend only)\n\n## Conditions\n\n### \u2705 Success\n- Pipeline with the given ID is present in PipelineManager\n- All variants are available\n\n### \u274c Failure\n- Unknown ID \u2192 404\n- Any other unhandled exception \u2192 500\n\n## Examples\n\n### Success Response (200)\n```json\n{\n  \"id\": \"pipeline-a3f5d9e1\",\n  \"name\": \"vehicle-detection\",\n  \"description\": \"Simple vehicle detection pipeline\",\n  \"source\": \"USER_CREATED\",\n  \"tags\": [\"detection\", \"vehicle\"],\n  \"variants\": [\n    {\n      \"id\": \"variant-1\",\n      \"name\": \"CPU\",\n      \"read_only\": false,\n      \"pipeline_graph\": {...},\n      \"pipeline_graph_simple\": {...},\n      \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n      \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n    }\n  ],\n  \"thumbnail\": null,\n  \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n  \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n}\n```\n\n### Error Response (404)\n```json\n{\n  \"message\": \"Pipeline with id 'pipeline-unknown' not found.\"\n}\n```",
        "operationId": "get_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pipeline details retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pipeline"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "pipelines"
        ],
        "summary": "Update Pipeline",
        "description": "**Partially update selected fields of an existing pipeline.**\n\n## Operation\n1. Validate request body via `PipelineUpdate` model\n2. Delegate to `PipelineManager.update_pipeline()`\n3. Backend automatically updates `modified_at` timestamp\n\n## Immutable Fields\nThe following fields **cannot** be updated via API:\n- `id` - Immutable identifier\n- `source` - Immutable source type\n- `thumbnail` - Only set for PREDEFINED pipelines from config files\n- `created_at` - Immutable creation timestamp\n- `modified_at` - Automatically updated by backend (UTC datetime)\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline to update\n\n## Request Body\n**`PipelineUpdate`** (validated by Pydantic) - any combination of:\n- `name` *(optional)* - New pipeline name (non-empty after trim)\n- `description` *(optional)* - New description (non-empty after trim)\n- `tags` *(optional)* - List of tags (can be empty)\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | Updated Pipeline object with new `modified_at` |\n| 400 | `MessageResponse` - Manager-level validation fails |\n| 404 | `MessageResponse` - Pipeline ID does not exist |\n| 422 | Pydantic validation error (no fields or empty values) |\n| 500 | `MessageResponse` - Unexpected error |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline with the given ID exists\n- At least one valid field is provided and passes validation\n\n### \u274c Failure\n- No fields provided \u2192 422 (Pydantic validation)\n- Empty name or description after trim \u2192 422 (Pydantic validation)\n- Unknown ID \u2192 404\n- Any other exception \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"name\": \"vehicle-detection-v2\",\n  \"description\": \"Updated pipeline with better preprocessing\",\n  \"tags\": [\"updated\", \"v2\"]\n}\n```\n\n### Success Response (200)\n```json\n{\n  \"id\": \"pipeline-a3f5d9e1\",\n  \"name\": \"vehicle-detection-v2\",\n  \"description\": \"Updated pipeline with better preprocessing\",\n  \"source\": \"USER_CREATED\",\n  \"tags\": [\"updated\", \"v2\"],\n  \"variants\": [...],\n  \"thumbnail\": null,\n  \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n  \"modified_at\": \"2026-02-05T15:45:00.456000+00:00\"\n}\n```\n\n### Error Response (422)\n```json\n{\n  \"detail\": [\n    {\n      \"type\": \"value_error\",\n      \"msg\": \"Value error, At least one of 'name', 'description', or 'tags' must be provided.\"\n    }\n  ]\n}\n```",
        "operationId": "update_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Pipeline successfully updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pipeline"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "pipelines"
        ],
        "summary": "Delete Pipeline",
        "description": "**Delete a pipeline by its ID.**\n\n## Operation\n1. Validate that pipeline exists\n2. Validate that pipeline is not PREDEFINED\n3. Delegate to `PipelineManager.delete_pipeline_by_id()`\n\n> **Note:** PREDEFINED pipelines cannot be deleted. They are loaded from\n> configuration files and include thumbnail images.\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline to delete\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `MessageResponse` confirming deletion |\n| 400 | `MessageResponse` - Trying to delete PREDEFINED pipeline |\n| 404 | `MessageResponse` - Pipeline with given ID does not exist |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline with the given ID is found\n- Pipeline is USER_CREATED (not PREDEFINED)\n- Pipeline is removed from manager\n\n### \u274c Failure\n- Pipeline is PREDEFINED \u2192 400\n- Unknown ID \u2192 404\n\n## Examples\n\n### Success Response (200)\n```json\n{\n  \"message\": \"Pipeline deleted\"\n}\n```\n\n### Error Response (400)\n```json\n{\n  \"message\": \"Cannot delete PREDEFINED pipeline 'pipeline-a3f5d9e1'.\"\n}\n```\n\n### Error Response (404)\n```json\n{\n  \"message\": \"Pipeline with id 'pipeline-unknown' not found.\"\n}\n```",
        "operationId": "delete_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pipeline successfully deleted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "400": {
            "description": "Cannot delete PREDEFINED pipeline",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/{pipeline_id}/variants/{variant_id}/optimize": {
      "post": {
        "tags": [
          "pipelines"
        ],
        "summary": "Optimize Variant",
        "description": "**Start asynchronous optimization job for a pipeline variant.**\n\n## Operation\n1. Validate that pipeline and variant exist\n2. Delegate to `OptimizationManager.run_optimization()` with variant\n3. Return generated job ID\n\n> **Note:** Optimization works with both read-only (PREDEFINED) and user-created variants.\n> The optimization job uses the variant's graphs as input but does not modify the original variant.\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline containing the variant\n- `variant_id` - ID of the variant to optimize\n\n## Request Body\n**`PipelineRequestOptimize`** with:\n- `type` *(required)* - Optimization type: `\"preprocess\"` or `\"optimize\"`\n- `parameters` *(optional)* - Optimizer-specific options, e.g.:\n  ```json\n  {\n    \"search_duration\": 300,\n    \"sample_duration\": 10\n  }\n  ```\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 202 | `OptimizationJobResponse` with `job_id` of created job |\n| 404 | `MessageResponse` - Pipeline or variant with given IDs do not exist |\n| 500 | `MessageResponse` - Unexpected error (e.g., graph conversion) |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline and variant exist\n- Variant's graph can be converted to a launch string\n- OptimizationManager starts a background job\n\n### \u274c Failure\n- Unknown pipeline or variant ID \u2192 404\n- Unhandled exception in pipeline/variant lookup or job creation \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"type\": \"optimize\",\n  \"parameters\": {\n    \"search_duration\": 300,\n    \"sample_duration\": 10\n  }\n}\n```\n\n### Success Response (202)\n```json\n{\n  \"job_id\": \"opt789\"\n}\n```",
        "operationId": "optimize_variant",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "variant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Variant Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineRequestOptimize"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Optimization job successfully started",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptimizationJobResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline or variant not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/{pipeline_id}/variants": {
      "post": {
        "tags": [
          "pipelines"
        ],
        "summary": "Create Variant",
        "description": "**Create a new variant for an existing pipeline.**\n\n## Operation\n1. Validate that pipeline exists\n2. Delegate to `PipelineManager.add_variant()`\n3. Return created variant with generated ID and timestamps\n\n## Auto-Generated Fields\nThe backend automatically sets:\n- Variant ID (generated from variant name)\n- `read_only=false` (user-created variants are never read-only)\n- `created_at` timestamp (current UTC time)\n- `modified_at` timestamp (same as `created_at` initially)\n- Pipeline's `modified_at` timestamp is also updated\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline to add variant to\n\n## Request Body\n**`VariantCreate`** with:\n- `name` *(required)* - Variant name (non-empty)\n- `pipeline_graph` *(required)* - Advanced graph representation\n- `pipeline_graph_simple` *(required)* - Simplified graph representation\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 201 | Complete Variant object with generated `id`, `read_only=false`, and timestamps |\n| 400 | `MessageResponse` - Invalid variant definition |\n| 404 | `MessageResponse` - Pipeline does not exist |\n| 500 | `MessageResponse` - Unexpected error |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline exists\n- Variant definition is valid\n- Variant is successfully added\n\n### \u274c Failure\n- Pipeline not found \u2192 404\n- Invalid variant definition \u2192 400\n- Any other exception \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"name\": \"GPU\",\n  \"pipeline_graph\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  },\n  \"pipeline_graph_simple\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  }\n}\n```\n\n### Success Response (201)\n```json\n{\n  \"id\": \"gpu\",\n  \"name\": \"GPU\",\n  \"read_only\": false,\n  \"pipeline_graph\": {...},\n  \"pipeline_graph_simple\": {...},\n  \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n  \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n}\n```",
        "operationId": "create_variant",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VariantCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Variant successfully created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Variant"
                }
              }
            }
          },
          "400": {
            "description": "Invalid variant definition",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/{pipeline_id}/variants/{variant_id}": {
      "delete": {
        "tags": [
          "pipelines"
        ],
        "summary": "Delete Variant",
        "description": "**Delete a variant from a pipeline.**\n\n## Operation\n1. Validate that pipeline and variant exist\n2. Check that variant is not read-only\n3. Check that variant is not the last one\n4. Delegate to `PipelineManager.delete_variant()`\n5. Pipeline's `modified_at` timestamp is updated\n\n## Restrictions\n**Cannot delete:**\n- Read-only variants (from PREDEFINED pipelines)\n- The last remaining variant of a pipeline\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline containing the variant\n- `variant_id` - ID of the variant to delete\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `MessageResponse` confirming deletion |\n| 400 | `MessageResponse` - Trying to delete read-only or last variant |\n| 404 | `MessageResponse` - Pipeline or variant not found |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline and variant exist\n- Variant is not read-only\n- Variant is not the last one\n- Variant is successfully deleted\n- Pipeline's `modified_at` is updated\n\n### \u274c Failure\n- Pipeline or variant not found \u2192 404\n- Variant is read-only \u2192 400\n- Variant is last one \u2192 400\n\n## Examples\n\n### Success Response (200)\n```json\n{\n  \"message\": \"Variant deleted\"\n}\n```\n\n### Error Response (400 - Read-only)\n```json\n{\n  \"message\": \"Cannot delete read-only variant 'variant-1'.\"\n}\n```\n\n### Error Response (400 - Last Variant)\n```json\n{\n  \"message\": \"Cannot delete variant 'variant-1' as it is the last variant in pipeline 'pipeline-a3f5d9e1'.\"\n}\n```",
        "operationId": "delete_variant",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "variant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Variant Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Variant successfully deleted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "400": {
            "description": "Cannot delete read-only variant or last variant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline or variant not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "pipelines"
        ],
        "summary": "Update Variant",
        "description": "**Update an existing variant.**\n\n## Operation\n1. Validate request body via `VariantUpdate` model\n2. Validate that pipeline and variant exist\n3. Check that variant is not read-only\n4. Delegate to `PipelineManager.update_variant()`\n5. Backend automatically updates variant's and pipeline's `modified_at` timestamps\n\n## Immutable Fields\nThe following fields **cannot** be updated via API:\n- `id` - Immutable identifier\n- `read_only` - Immutable flag\n- `created_at` - Immutable creation timestamp\n- `modified_at` - Automatically updated by backend\n\n## Restrictions\n- Only one of `pipeline_graph` or `pipeline_graph_simple` can be provided per request\n- Cannot update read-only variants (from PREDEFINED pipelines)\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline containing the variant\n- `variant_id` - ID of the variant to update\n\n## Request Body\n**`VariantUpdate`** (validated by Pydantic) - any combination of:\n- `name` *(optional)* - Variant name (non-empty after trim)\n- `pipeline_graph` *(optional)* - Advanced graph (mutually exclusive with `pipeline_graph_simple`)\n- `pipeline_graph_simple` *(optional)* - Simplified graph (mutually exclusive with `pipeline_graph`)\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | Updated Variant object with new `modified_at` |\n| 400 | `MessageResponse` - Variant is read-only |\n| 404 | `MessageResponse` - Pipeline or variant not found |\n| 422 | Pydantic validation error (no fields, both graphs, or empty name) |\n| 500 | `MessageResponse` - Unexpected error |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline and variant exist\n- Variant is not read-only\n- At least one field provided\n- At most one graph field provided\n- Name is non-empty after trim (if provided)\n- Variant is successfully updated\n- Variant's and pipeline's `modified_at` are updated\n\n### \u274c Failure\n- Pipeline or variant not found \u2192 404\n- Variant is read-only \u2192 400\n- Invalid request (no fields, both graphs, empty name) \u2192 422 (Pydantic validation)\n- Any other exception \u2192 500\n\n## Examples\n\n### Request (Update Name)\n```json\n{\n  \"name\": \"GPU-optimized\"\n}\n```\n\n### Request (Update Advanced Graph)\n```json\n{\n  \"pipeline_graph\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  }\n}\n```\n\n### Success Response (200)\n```json\n{\n  \"id\": \"variant-1\",\n  \"name\": \"GPU-optimized\",\n  \"read_only\": false,\n  \"pipeline_graph\": {...},\n  \"pipeline_graph_simple\": {...},\n  \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n  \"modified_at\": \"2026-02-05T15:45:00.456000+00:00\"\n}\n```\n\n### Error Response (400 - Read-only)\n```json\n{\n  \"message\": \"Cannot update read-only variant 'variant-1'.\"\n}\n```\n\n### Error Response (422 - Empty Name)\n```json\n{\n  \"detail\": [\n    {\n      \"type\": \"value_error\",\n      \"msg\": \"Value error, Field 'name' must not be empty.\"\n    }\n  ]\n}\n```",
        "operationId": "update_variant",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "variant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Variant Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VariantUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Variant successfully updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Variant"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or cannot update read-only variant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline or variant not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/{pipeline_id}/variants/{variant_id}/convert-to-simple": {
      "post": {
        "tags": [
          "pipelines"
        ],
        "summary": "Convert to Simple Graph",
        "description": "**Convert advanced pipeline graph to simplified view (read-only operation).**\n\n## Operation\n1. Validate that pipeline and variant exist\n2. Convert provided advanced graph (PipelineGraph) to Graph object\n3. Validate advanced graph and generate simplified view\n4. Return simplified graph **without modifying the variant**\n\n> **Note:** This is a read-only conversion. To save changes, use\n> `PATCH /{pipeline_id}/variants/{variant_id}` with `pipeline_graph`.\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline containing the variant\n- `variant_id` - ID of the variant (used for context/validation)\n\n## Request Body\n**`PipelineGraph`** - Advanced graph with all pipeline elements to convert\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `PipelineGraph` representing the simplified view |\n| 400 | `MessageResponse` - Invalid graph or conversion failed |\n| 404 | `MessageResponse` - Pipeline or variant not found |\n| 500 | `MessageResponse` - Unexpected error |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline and variant exist\n- Advanced graph is valid and can be converted to GStreamer pipeline\n- Simplified view is generated successfully\n\n### \u274c Failure\n- Pipeline or variant not found \u2192 404\n- Invalid graph structure \u2192 400\n- Conversion error \u2192 400\n- Any other exception \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"nodes\": [\n    {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"video.mp4\"}},\n    {\"id\": \"1\", \"type\": \"queue\", \"data\": {}},\n    {\"id\": \"2\", \"type\": \"gvadetect\", \"data\": {\"model\": \"detection\"}},\n    {\"id\": \"3\", \"type\": \"fakesink\", \"data\": {}}\n  ],\n  \"edges\": [\n    {\"id\": \"0\", \"source\": \"0\", \"target\": \"1\"},\n    {\"id\": \"1\", \"source\": \"1\", \"target\": \"2\"},\n    {\"id\": \"2\", \"source\": \"2\", \"target\": \"3\"}\n  ]\n}\n```\n\n### Success Response (200)\n```json\n{\n  \"nodes\": [\n    {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"video.mp4\"}},\n    {\"id\": \"2\", \"type\": \"gvadetect\", \"data\": {\"model\": \"detection\"}},\n    {\"id\": \"3\", \"type\": \"fakesink\", \"data\": {}}\n  ],\n  \"edges\": [\n    {\"id\": \"0\", \"source\": \"0\", \"target\": \"2\"},\n    {\"id\": \"1\", \"source\": \"2\", \"target\": \"3\"}\n  ]\n}\n```",
        "operationId": "convert_advanced_to_simple",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "variant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Variant Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineGraph"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfully converted to simplified graph",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PipelineGraph"
                }
              }
            }
          },
          "400": {
            "description": "Invalid graph or conversion failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline or variant not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/pipelines/{pipeline_id}/variants/{variant_id}/convert-to-advanced": {
      "post": {
        "tags": [
          "pipelines"
        ],
        "summary": "Convert to Advanced Graph",
        "description": "**Convert simplified pipeline graph to advanced view (read-only operation).**\n\n## Operation\n1. Validate that pipeline and variant exist\n2. Convert provided simple graph (PipelineGraph) to Graph object\n3. Validate simple graph changes and merge into advanced view\n4. Return updated advanced graph **without modifying the variant**\n\n> **Note:** This is a read-only conversion. The conversion uses the variant's current\n> advanced graph as base and applies property changes from the simple graph.\n>\n> To save changes, use `PATCH /{pipeline_id}/variants/{variant_id}` with `pipeline_graph_simple`.\n>\n> **Only property modifications are allowed.** Structural changes (adding/removing\n> nodes or edges) will be rejected.\n\n## Path Parameters\n- `pipeline_id` - ID of the pipeline containing the variant\n- `variant_id` - ID of the variant whose advanced graph is used as base\n\n## Request Body\n**`PipelineGraph`** - Simplified graph with property changes to apply\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `PipelineGraph` representing the updated advanced view |\n| 400 | `MessageResponse` - Invalid graph, structural changes, or merge failed |\n| 404 | `MessageResponse` - Pipeline or variant not found |\n| 500 | `MessageResponse` - Unexpected error |\n\n## Conditions\n\n### \u2705 Success\n- Pipeline and variant exist\n- Simple graph contains **only property changes** (no structural changes)\n- Changes can be merged into advanced graph\n- Resulting advanced graph is valid\n\n### \u274c Failure\n- Pipeline or variant not found \u2192 404\n- Structural changes detected (nodes/edges added/removed) \u2192 400\n- Invalid resulting graph \u2192 400\n- Any other exception \u2192 500\n\n## Examples\n\n### Request\n```json\n{\n  \"nodes\": [\n    {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"new_video.mp4\"}},\n    {\"id\": \"2\", \"type\": \"gvadetect\", \"data\": {\"model\": \"new_model\"}},\n    {\"id\": \"3\", \"type\": \"fakesink\", \"data\": {}}\n  ],\n  \"edges\": [\n    {\"id\": \"0\", \"source\": \"0\", \"target\": \"2\"},\n    {\"id\": \"1\", \"source\": \"2\", \"target\": \"3\"}\n  ]\n}\n```\n\n### Success Response (200)\n```json\n{\n  \"nodes\": [\n    {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"new_video.mp4\"}},\n    {\"id\": \"1\", \"type\": \"queue\", \"data\": {}},\n    {\"id\": \"2\", \"type\": \"gvadetect\", \"data\": {\"model\": \"new_model\"}},\n    {\"id\": \"3\", \"type\": \"fakesink\", \"data\": {}}\n  ],\n  \"edges\": [\n    {\"id\": \"0\", \"source\": \"0\", \"target\": \"1\"},\n    {\"id\": \"1\", \"source\": \"1\", \"target\": \"2\"},\n    {\"id\": \"2\", \"source\": \"2\", \"target\": \"3\"}\n  ]\n}\n```\n\n### Error Response (400 - Structural Change)\n```json\n{\n  \"message\": \"Invalid pipeline_graph_simple: Node additions are not supported in simple view. Added nodes: 4. Please use advanced view to add new nodes.\"\n}\n```",
        "operationId": "convert_simple_to_advanced",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "variant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Variant Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PipelineGraph"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfully converted to advanced graph",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PipelineGraph"
                }
              }
            }
          },
          "400": {
            "description": "Invalid graph or conversion failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Pipeline or variant not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/tests/performance": {
      "post": {
        "tags": [
          "tests"
        ],
        "summary": "Start a performance test job",
        "description": "**Start an asynchronous performance test job.**\n\n## Operation\n\n1. Validates the performance test request\n2. Creates a PerformanceJob with RUNNING state\n3. Spawns a background thread that runs the pipelines using a GStreamer-based runner\n4. Returns the job identifier for status polling\n\n## Request Body\n\n- `pipeline_performance_specs`: List of pipelines and number of streams per pipeline. Each pipeline can be:\n  - Variant reference: `{\"source\": \"variant\", \"pipeline_id\": \"...\", \"variant_id\": \"...\"}`\n  - Inline graph: `{\"source\": \"graph\", \"pipeline_graph\": {...}}`\n  - Pipeline description: `{\"source\": \"description\", \"pipeline_description\": \"...\"}`\n- `execution_config`: Configuration for output mode, metadata mode and runtime limits\n  - `output_mode`: disabled (default), file, or live_stream\n  - `max_runtime`: maximum runtime in seconds (0 = run until EOS)\n  - `metadata_mode`: disabled (default) or file\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 202  | TestJobResponse with job_id of the created performance job |\n| 400  | Invalid request (empty specs, duplicate pipeline_ids, zero streams, missing variant, invalid output config) |\n| 500  | Unexpected error when creating the job or starting background thread |\n\n## Conditions\n\n### \u2705 Success\n- At least one stream is requested across all pipelines\n- All referenced variants exist\n- No duplicate pipeline_ids in request\n- TestsManager.test_performance() successfully enqueues the job\n\n### \u274c Failure\n- Validation or configuration error \u2192 400\n- Unhandled exception in job creation \u2192 500\n\n## Examples\n\nRequest (variant reference):\n```json\n{\n  \"pipeline_performance_specs\": [\n    {\n      \"pipeline\": {\n        \"source\": \"variant\",\n        \"pipeline_id\": \"pipeline-a3f5d9e1\",\n        \"variant_id\": \"variant-abc123\"\n      },\n      \"streams\": 8\n    }\n  ],\n  \"execution_config\": {\n    \"output_mode\": \"disabled\",\n    \"max_runtime\": 0,\n    \"metadata_mode\": \"disabled\"\n  }\n}\n```\n\nRequest (inline graph):\n```json\n{\n  \"pipeline_performance_specs\": [\n    {\n      \"pipeline\": {\n        \"source\": \"graph\",\n        \"pipeline_graph\": {\n          \"nodes\": [...],\n          \"edges\": [...]\n        }\n      },\n      \"streams\": 4\n    }\n  ],\n  \"execution_config\": {\n    \"output_mode\": \"disabled\",\n    \"max_runtime\": 0,\n    \"metadata_mode\": \"disabled\"\n  }\n}\n```\n\nSuccess (202):\n```json\n{\n  \"job_id\": \"job123\"\n}\n```\n\nError (400):\n```json\n{\n  \"message\": \"At least one stream must be specified to run the pipeline.\"\n}\n```",
        "operationId": "run_performance_test",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PerformanceTestSpec"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Performance test job created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TestJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid performance test request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error while starting performance test",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/tests/density": {
      "post": {
        "tags": [
          "tests"
        ],
        "summary": "Start a density test job",
        "description": "**Start an asynchronous density test job.**\n\n## Operation\n\n1. Validates the density test request\n2. Uses requested fps_floor and per-pipeline stream_rate ratios\n3. Creates a DensityJob with RUNNING state\n4. Spawns a background thread that runs a Benchmark to determine the maximum number of streams that still meets fps_floor\n5. Returns the job identifier for status polling\n\n## Request Body\n\n- `fps_floor`: Minimum acceptable FPS per stream\n- `pipeline_density_specs`: List of pipelines with stream_rate percentages that must sum to 100. Each pipeline can be:\n  - Variant reference: `{\"source\": \"variant\", \"pipeline_id\": \"...\", \"variant_id\": \"...\"}`\n  - Inline graph: `{\"source\": \"graph\", \"pipeline_graph\": {...}}`\n  - Pipeline description: `{\"source\": \"description\", \"pipeline_description\": \"...\"}`\n- `execution_config`: Configuration for output mode, metadata mode and runtime limits\n  - `output_mode`: disabled (default) or file (live_stream not supported)\n  - `max_runtime`: maximum runtime in seconds (0 = run until EOS)\n  - `metadata_mode`: must be disabled (metadata output not supported)\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 202  | TestJobResponse with job_id of the created density job |\n| 400  | Invalid request (empty specs, duplicate pipeline_ids, stream_rate not summing to 100, missing variant, live_stream mode, invalid output config) |\n| 500  | Unexpected error when creating or starting the job |\n\n## Conditions\n\n### \u2705 Success\n- pipeline_density_specs is not empty\n- All referenced variants exist\n- No duplicate pipeline_ids in request\n- stream_rate ratios sum to 100%\n- DensityTestSpec is valid and Benchmark.run() can be started in background thread\n\n### \u274c Failure\n- Validation errors \u2192 400\n- Unhandled exception \u2192 500\n\n## Examples\n\nRequest (variant reference):\n```json\n{\n  \"fps_floor\": 30,\n  \"pipeline_density_specs\": [\n    {\n      \"pipeline\": {\n        \"source\": \"variant\",\n        \"pipeline_id\": \"pipeline-a3f5d9e1\",\n        \"variant_id\": \"variant-abc123\"\n      },\n      \"stream_rate\": 50\n    },\n    {\n      \"pipeline\": {\n        \"source\": \"variant\",\n        \"pipeline_id\": \"pipeline-b7c2e114\",\n        \"variant_id\": \"variant-def456\"\n      },\n      \"stream_rate\": 50\n    }\n  ],\n  \"execution_config\": {\n    \"output_mode\": \"disabled\",\n    \"max_runtime\": 0,\n    \"metadata_mode\": \"disabled\"\n  }\n}\n```\n\nRequest (inline graph):\n```json\n{\n  \"fps_floor\": 30,\n  \"pipeline_density_specs\": [\n    {\n      \"pipeline\": {\n        \"source\": \"graph\",\n        \"pipeline_graph\": {\n          \"nodes\": [...],\n          \"edges\": [...]\n        }\n      },\n      \"stream_rate\": 100\n    }\n  ],\n  \"execution_config\": {\n    \"output_mode\": \"disabled\",\n    \"max_runtime\": 0,\n    \"metadata_mode\": \"disabled\"\n  }\n}\n```\n\nSuccess (202):\n```json\n{\n  \"job_id\": \"job456\"\n}\n```\n\nError (400):\n```json\n{\n  \"message\": \"Pipeline stream_rate ratios must sum to 100%, got 110%\"\n}\n```",
        "operationId": "run_density_test",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DensityTestSpec"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Density test job created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TestJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid density test request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error while starting density test",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/videos": {
      "get": {
        "tags": [
          "videos"
        ],
        "summary": "List all available input videos",
        "description": "**List all discovered input videos with metadata.**\n\n## Operation\n\n1. VideosManager scans INPUT_VIDEO_DIR for supported video files (h264/h265 codecs only)\n2. Metadata is loaded or extracted for each file (resolution, fps, duration, codec)\n3. Returns array of Video objects\n\n## Parameters\n\nNone\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 200  | JSON array of Video objects (empty if no videos found) |\n| 500  | Runtime error during video listing |\n\n## Conditions\n\n### \u2705 Success\n- VideosManager successfully initialized at startup\n- INPUT_VIDEO_DIR exists and is a valid directory\n\n### \u274c Failure\n- VideosManager initialization fails \u2192 application exits at startup\n- Runtime errors \u2192 500\n\n## Example Response\n\n```json\n[\n  {\n    \"filename\": \"traffic_1080p_h264.mp4\",\n    \"width\": 1920,\n    \"height\": 1080,\n    \"fps\": 30.0,\n    \"frame_count\": 900,\n    \"codec\": \"h264\",\n    \"duration\": 30.0\n  },\n  {\n    \"filename\": \"people_720p_h265.mp4\",\n    \"width\": 1280,\n    \"height\": 720,\n    \"fps\": 25.0,\n    \"frame_count\": 2500,\n    \"codec\": \"h265\",\n    \"duration\": 100.0\n  }\n]\n```",
        "operationId": "get_videos",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Video"
                  },
                  "type": "array",
                  "title": "Response Get Videos"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "videos"
        ],
        "summary": "Upload a new video file",
        "description": "**Upload a new video file to the INPUT_VIDEO_DIR.**\n\n## Operation\n\n1. Validate file extension against supported formats\n2. Save file to INPUT_VIDEO_DIR in 8KB chunks\n3. Extract video metadata (resolution, fps, codec, etc.)\n4. Create TS conversion for looping support\n5. Return Video object with extracted metadata\n\n## Parameters\n\n- `file` (multipart/form-data) - Video file to upload\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 201  | Video uploaded successfully, returns Video object |\n| 400  | Invalid file (unsupported extension or codec, duplicate filename) |\n| 500  | Error during upload or processing |\n\n## Conditions\n\n### \u2705 Success\n- File has supported video extension (mp4, mkv, mov, avi, ts, 264, avc, h265, hevc)\n- File has supported codec (h264 or h265)\n- No file with same name exists in INPUT_VIDEO_DIR\n- Video metadata extraction successful\n\n### \u274c Failure\n- No file provided \u2192 400\n- File extension not supported \u2192 400\n- Filename already exists \u2192 400\n- Video codec not h264/h265 \u2192 400\n- Cannot extract metadata \u2192 500\n- Write error \u2192 500\n\n## Example Response\n\n```json\n{\n  \"filename\": \"uploaded_video.mp4\",\n  \"width\": 1920,\n  \"height\": 1080,\n  \"fps\": 30.0,\n  \"frame_count\": 1800,\n  \"codec\": \"h264\",\n  \"duration\": 60.0\n}\n```",
        "operationId": "upload_video",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_video"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Video"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/videos/check-video-input-exists": {
      "get": {
        "tags": [
          "videos"
        ],
        "summary": "Check if a video file already exists",
        "description": "**Check if a video file with the given filename already exists in INPUT_VIDEO_DIR.**\n\n## Operation\n\n1. Validates filename against INPUT_VIDEO_DIR\n2. Returns whether the file exists\n\n## Parameters\n\n- `filename` (query) - Name of the video file to check\n\n## Response Format\n\n| Code | Description |\n|------|-------------|\n| 200  | Returns VideoExistsResponse with exists boolean |\n\n## Conditions\n\n### \u2705 Success\n- Always succeeds with boolean response\n\n## Example Response\n\n```json\n{\n  \"exists\": true,\n  \"filename\": \"traffic_1080p_h264.mp4\"\n}\n```",
        "operationId": "check_video_input_exists",
        "parameters": [
          {
            "name": "filename",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Video filename to check",
              "title": "Filename"
            },
            "description": "Video filename to check"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VideoExistsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/cameras": {
      "get": {
        "tags": [
          "cameras"
        ],
        "summary": "Get all cameras",
        "description": "**Get all cameras (both USB and network) available to the system.**\n\n## Operation\nCombines results from both USB and network camera discovery to provide\na comprehensive list of all available camera devices.\n\n1. Discover all USB cameras using v4l2-ctl or device scanning\n2. Discover all network cameras using various protocols\n3. Combine and return the complete list\n\n## Parameters\n- **Path/Query parameters:** None\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | JSON array of Camera objects (USB and network cameras) |\n| 500 | `MessageResponse` - Unexpected error during discovery |\n\n## Conditions\n\n### \u2705 Success\n- At least one discovery method succeeds\n- Results can be combined and returned\n- Empty list is returned if no cameras are found\n\n### \u274c Failure\n- Both USB and network discovery fail\n- System error during discovery process\n\n## Example Response\n\n```json\n[\n  {\n    \"device_id\": \"usb-camera-0\",\n    \"device_name\": \"Integrated Camera\",\n    \"device_type\": \"USB\",\n    \"details\": {\n      \"device_path\": \"/dev/video0\",\n      \"resolution\": \"1920x1080\"\n    }\n  },\n  {\n    \"device_id\": \"network-camera-192.168.1.100-80\",\n    \"device_name\": \"ONVIF Camera 192.168.1.100\",\n    \"device_type\": \"NETWORK\",\n    \"details\": {\n      \"ip\": \"192.168.1.100\",\n      \"port\": 80,\n      \"profiles\": []\n    }\n  }\n]\n```",
        "operationId": "get_cameras",
        "responses": {
          "200": {
            "description": "List of all cameras successfully retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Camera"
                  },
                  "type": "array",
                  "title": "Response 200 Get Cameras"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error when discovering cameras.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          }
        }
      }
    },
    "/cameras/{camera_id}": {
      "get": {
        "tags": [
          "cameras"
        ],
        "summary": "Get camera by ID",
        "description": "**Get a specific camera by its ID.**\n\n## Operation\nRetrieves information about a single camera device using its unique identifier.\nThe camera must be already discovered and cached.\n\n1. Search for the camera in the cached cameras list\n2. Return camera details if found\n\n## Path Parameters\n- `camera_id` - The unique identifier of the camera (e.g., `\"usb-camera-0\"` or `\"network-camera-192.168.1.100-80\"`)\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | JSON object containing camera details |\n| 404 | `MessageResponse` - Camera with the given ID not found |\n| 500 | `MessageResponse` - Unexpected error during retrieval |\n\n## Conditions\n\n### \u2705 Success\n- Camera with the given ID exists in the cache\n\n### \u274c Failure\n- Camera with the given ID does not exist \u2192 404\n- System error during retrieval \u2192 500\n\n## Example Response\n\n```json\n{\n  \"device_id\": \"usb-camera-0\",\n  \"device_name\": \"Integrated Camera\",\n  \"device_type\": \"USB\",\n  \"details\": {\n    \"device_path\": \"/dev/video0\",\n    \"resolution\": \"1920x1080\"\n  }\n}\n```",
        "operationId": "get_camera",
        "parameters": [
          {
            "name": "camera_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Camera Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Camera successfully retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Camera"
                }
              }
            }
          },
          "404": {
            "description": "Camera not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error when retrieving camera.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/cameras/{camera_id}/profiles": {
      "post": {
        "tags": [
          "cameras"
        ],
        "summary": "Load camera ONVIF profiles",
        "description": "**Load ONVIF profiles from a network camera.**\n\n## Operation\nConnects to a specific ONVIF-compatible network camera using the provided\ncredentials and loads all available media profiles from the camera.\n\n1. Parse the `camera_id` to extract IP address and port\n2. Establish ONVIF connection with provided credentials\n3. Load all available media profiles from the camera\n4. Update the cached camera with profile information\n5. Return updated camera object\n\n## Path Parameters\n- `camera_id` - Unique identifier of the camera (e.g., `\"network-camera-192.168.1.100-80\"`)\n\n## Request Body\n**`CameraProfilesRequest`** with:\n- `username` *(required)* - ONVIF camera username\n- `password` *(required)* - ONVIF camera password\n\n## Response Codes\n\n| Code | Description |\n|------|-------------|\n| 200 | `CameraAuthResponse` with updated camera object containing profiles |\n| 400 | `MessageResponse` - Invalid camera_id format |\n| 401 | `MessageResponse` - Credentials rejected by camera |\n| 404 | `MessageResponse` - Camera not found or not reachable |\n| 500 | `MessageResponse` - Unexpected error during profile loading |\n\n## Conditions\n\n### \u2705 Success\n- Camera is reachable on the network\n- Credentials are valid\n- Camera supports ONVIF protocol\n\n### \u274c Failure\n- Invalid camera_id format \u2192 400\n- Camera is offline or unreachable \u2192 404\n- Invalid credentials \u2192 401\n\n## Example Response\n\n```json\n{\n  \"camera\": {\n    \"device_id\": \"network-camera-192.168.1.100-80\",\n    \"device_name\": \"ONVIF Camera 192.168.1.100\",\n    \"device_type\": \"NETWORK\",\n    \"details\": {\n      \"ip\": \"192.168.1.100\",\n      \"port\": 80,\n      \"profiles\": [\n        {\n          \"name\": \"Profile_1\",\n          \"rtsp_url\": \"rtsp://192.168.1.100:554/stream1\",\n          \"resolution\": \"1920x1080\",\n          \"encoding\": \"H264\",\n          \"framerate\": 30,\n          \"bitrate\": 4096\n        },\n        {\n          \"name\": \"Profile_2\",\n          \"rtsp_url\": \"rtsp://192.168.1.100:554/stream2\",\n          \"resolution\": \"1280x720\",\n          \"encoding\": \"H264\",\n          \"framerate\": 15,\n          \"bitrate\": 2048\n        }\n      ]\n    }\n  }\n}\n```",
        "operationId": "load_camera_profiles",
        "parameters": [
          {
            "name": "camera_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Camera Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CameraProfilesRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Camera profiles loaded successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CameraAuthResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid camera ID format.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "401": {
            "description": "Failed to load profiles - invalid credentials.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "404": {
            "description": "Camera not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error when loading camera profiles.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AppStatus": {
        "type": "string",
        "enum": [
          "starting",
          "initializing",
          "ready",
          "shutdown"
        ],
        "title": "AppStatus",
        "description": "**Application status enum for tracking initialization progress.**\n\n## Values\n- `STARTING` - Application is starting, no initialization yet\n- `INITIALIZING` - Application is initializing resources (e.g., loading videos)\n- `READY` - Application is fully initialized and ready to serve requests\n- `SHUTDOWN` - Application is shutting down\n\n### Example\n```json\n\"ready\"\n```"
      },
      "Body_upload_video": {
        "properties": {
          "file": {
            "type": "string",
            "contentMediaType": "application/octet-stream",
            "title": "File"
          }
        },
        "type": "object",
        "required": [
          "file"
        ],
        "title": "Body_upload_video"
      },
      "Camera": {
        "properties": {
          "device_id": {
            "type": "string",
            "title": "Device Id"
          },
          "device_name": {
            "type": "string",
            "title": "Device Name"
          },
          "device_type": {
            "$ref": "#/components/schemas/CameraType"
          },
          "details": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/USBCameraDetails"
              },
              {
                "$ref": "#/components/schemas/NetworkCameraDetails"
              }
            ],
            "title": "Details"
          }
        },
        "type": "object",
        "required": [
          "device_id",
          "device_name",
          "device_type",
          "details"
        ],
        "title": "Camera",
        "description": "**Camera device information supporting both USB and network cameras.**\n\nCommon attributes apply to all camera types. Type-specific details are stored\nin the details field which contains either USBCameraDetails or NetworkCameraDetails.\n\n## Attributes\n- `device_id` - Unique identifier for the camera\n- `device_name` - Human-readable camera name\n- `device_type` - Type of camera (USB or NETWORK)\n- `details` - Type-specific camera details (USBCameraDetails for USB, NetworkCameraDetails for NETWORK)\n\n### Example (USB Camera)\n```json\n{\n  \"device_id\": \"usb-camera-0\",\n  \"device_name\": \"Integrated Camera\",\n  \"device_type\": \"USB\",\n  \"details\": {\n    \"device_path\": \"/dev/video0\",\n    \"best_capture\": {\n      \"fourcc\": \"YUYV\",\n      \"width\": 1920,\n      \"height\": 1080,\n      \"fps\": 30\n    }\n  }\n}\n```\n\n### Example (Network Camera)\n```json\n{\n  \"device_id\": \"network-camera-192.168.1.100-80\",\n  \"device_name\": \"ONVIF Camera 192.168.1.100\",\n  \"device_type\": \"NETWORK\",\n  \"details\": {\n    \"ip\": \"192.168.1.100\",\n    \"port\": 80,\n    \"profiles\": [\n      {\n        \"name\": \"Profile_1\",\n        \"rtsp_url\": \"rtsp://192.168.1.100:554/stream1\",\n        \"resolution\": \"1920x1080\",\n        \"encoding\": \"H264\",\n        \"framerate\": 30,\n        \"bitrate\": 4096\n      }\n    ],\n    \"best_profile\": {\n      \"name\": \"Profile_1\",\n      \"rtsp_url\": \"rtsp://192.168.1.100:554/stream1\",\n      \"resolution\": \"1920x1080\",\n      \"encoding\": \"H264\",\n      \"framerate\": 30,\n      \"bitrate\": 4096\n    }\n  }\n}\n```"
      },
      "CameraAuthResponse": {
        "properties": {
          "camera": {
            "$ref": "#/components/schemas/Camera",
            "description": "Camera object with populated ONVIF profiles after successful authentication."
          }
        },
        "type": "object",
        "required": [
          "camera"
        ],
        "title": "CameraAuthResponse",
        "description": "**Response model for camera authentication attempt.**\n\nReturns the authenticated camera with populated ONVIF profiles.\nAfter successful authentication, the camera's profile list is updated\nwith all available ONVIF profiles from the device.\n\n## Attributes\n- `camera` - Camera object with updated profile list (includes all ONVIF profiles available on the device)\n\n### Example\n```json\n{\n  \"camera\": {\n    \"device_id\": \"network-camera-192.168.1.100-80\",\n    \"device_name\": \"ONVIF Camera 192.168.1.100\",\n    \"device_type\": \"NETWORK\",\n    \"details\": {\n      \"ip\": \"192.168.1.100\",\n      \"port\": 80,\n      \"profiles\": [...]\n    }\n  }\n}\n```"
      },
      "CameraProfileInfo": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "rtsp_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rtsp Url"
          },
          "resolution": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolution"
          },
          "encoding": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Encoding"
          },
          "framerate": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Framerate"
          },
          "bitrate": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bitrate"
          }
        },
        "type": "object",
        "required": [
          "name"
        ],
        "title": "CameraProfileInfo",
        "description": "**Detailed ONVIF camera profile information.**\n\n## Attributes\n- `name` - Profile name\n- `rtsp_url` - RTSP stream URL\n- `resolution` - Video resolution (e.g., \"1920x1080\")\n- `encoding` - Video encoding format (e.g., \"H264\", \"MPEG4\")\n- `framerate` - Frame rate limit\n- `bitrate` - Bitrate limit\n\n### Example\n```json\n{\n  \"name\": \"Profile_1\",\n  \"rtsp_url\": \"rtsp://192.168.1.100:554/stream1\",\n  \"resolution\": \"1920x1080\",\n  \"encoding\": \"H264\",\n  \"framerate\": 30,\n  \"bitrate\": 4096\n}\n```"
      },
      "CameraProfilesRequest": {
        "properties": {
          "username": {
            "type": "string",
            "title": "Username"
          },
          "password": {
            "type": "string",
            "title": "Password"
          }
        },
        "type": "object",
        "required": [
          "username",
          "password"
        ],
        "title": "CameraProfilesRequest",
        "description": "**Request model for camera profile retrieval.**\n\nCamera ID is provided in the path parameter.\n\n## Attributes\n- `username` - Username for ONVIF authentication\n- `password` - Password for ONVIF authentication\n\n### Example\n```json\n{\n  \"username\": \"admin\",\n  \"password\": \"password123\"\n}\n```"
      },
      "CameraType": {
        "type": "string",
        "enum": [
          "USB",
          "NETWORK"
        ],
        "title": "CameraType",
        "description": "**Type of camera device.**\n\n## Values\n- `USB` - USB camera connected directly to the system\n- `NETWORK` - Network camera accessible via IP protocols\n\n### Example\n```json\n\"USB\"\n```"
      },
      "DensityJobStatus": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "start_time": {
            "type": "integer",
            "title": "Start Time"
          },
          "elapsed_time": {
            "type": "integer",
            "title": "Elapsed Time"
          },
          "state": {
            "$ref": "#/components/schemas/TestJobState"
          },
          "details": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Details"
          },
          "total_fps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Fps"
          },
          "per_stream_fps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Per Stream Fps"
          },
          "total_streams": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Streams"
          },
          "streams_per_pipeline": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PipelineStreamSpec"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Streams Per Pipeline"
          },
          "video_output_paths": {
            "anyOf": [
              {
                "additionalProperties": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Video Output Paths"
          }
        },
        "type": "object",
        "required": [
          "id",
          "start_time",
          "elapsed_time",
          "state",
          "details",
          "total_fps",
          "per_stream_fps",
          "total_streams",
          "streams_per_pipeline",
          "video_output_paths"
        ],
        "title": "DensityJobStatus",
        "description": "**Status of a density test job.**\n\nInherits all fields from TestsJobStatus without changes.\nDoes not include live_stream_urls because density tests do not support\nlive-streaming output mode (only disabled or file modes are allowed).\n\n## Attributes\n- *Inherited from TestsJobStatus* - id, start_time, elapsed_time, state, details, total_fps, per_stream_fps, total_streams, streams_per_pipeline, video_output_paths"
      },
      "DensityJobSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "request": {
            "additionalProperties": true,
            "type": "object",
            "title": "Request"
          }
        },
        "type": "object",
        "required": [
          "id",
          "request"
        ],
        "title": "DensityJobSummary",
        "description": "**Short summary for a density test job.**\n\n## Attributes\n- `id` - Job identifier\n- `request` - Original DensityTestSpec used to start the job (stored as dict and validated on output)\n\n### Example\n```json\n{\n  \"id\": \"job456\",\n  \"request\": {\n    \"fps_floor\": 30,\n    \"pipeline_density_specs\": [...],\n    \"execution_config\": {...}\n  }\n}\n```"
      },
      "DensityTestSpec": {
        "properties": {
          "fps_floor": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Fps Floor",
            "description": "Minimum acceptable FPS per stream.",
            "examples": [
              30
            ]
          },
          "pipeline_density_specs": {
            "items": {
              "$ref": "#/components/schemas/PipelineDensitySpec"
            },
            "type": "array",
            "title": "Pipeline Density Specs",
            "description": "List of pipelines with relative stream_rate percentages that must sum to 100.",
            "examples": [
              [
                {
                  "pipeline": {
                    "pipeline_id": "pipeline-a3f5d9e1",
                    "source": "variant",
                    "variant_id": "variant-abc123"
                  },
                  "stream_rate": 50
                },
                {
                  "pipeline": {
                    "pipeline_id": "pipeline-b7c2e114",
                    "source": "variant",
                    "variant_id": "variant-def456"
                  },
                  "stream_rate": 50
                }
              ]
            ]
          },
          "execution_config": {
            "$ref": "#/components/schemas/ExecutionConfig",
            "description": "Execution configuration for output and runtime.",
            "default": {
              "output_mode": "disabled",
              "max_runtime": 0.0,
              "metadata_mode": "disabled"
            },
            "examples": [
              {
                "max_runtime": 0,
                "metadata_mode": "disabled",
                "output_mode": "disabled"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "fps_floor",
          "pipeline_density_specs"
        ],
        "title": "DensityTestSpec",
        "description": "**Request body for starting a density test.**\n\n## Attributes\n- `fps_floor` - Minimum acceptable FPS per stream\n- `pipeline_density_specs` - List of pipelines with relative stream_rate ratios\n- `execution_config` - Configuration for output generation, metadata publishing and runtime limits\n\n### Example\n```json\n{\n  \"fps_floor\": 30,\n  \"pipeline_density_specs\": [\n    {\n      \"pipeline\": {\n        \"source\": \"variant\",\n        \"pipeline_id\": \"pipeline-a3f5d9e1\",\n        \"variant_id\": \"variant-abc123\"\n      },\n      \"stream_rate\": 50\n    },\n    {\n      \"pipeline\": {\n        \"source\": \"variant\",\n        \"pipeline_id\": \"pipeline-b4c6e2f8\",\n        \"variant_id\": \"variant-def456\"\n      },\n      \"stream_rate\": 50\n    }\n  ],\n  \"execution_config\": {\n    \"output_mode\": \"disabled\",\n    \"max_runtime\": 0,\n    \"metadata_mode\": \"disabled\"\n  }\n}\n```"
      },
      "Device": {
        "properties": {
          "device_name": {
            "type": "string",
            "title": "Device Name"
          },
          "full_device_name": {
            "type": "string",
            "title": "Full Device Name"
          },
          "device_type": {
            "$ref": "#/components/schemas/DeviceType"
          },
          "device_family": {
            "$ref": "#/components/schemas/DeviceFamily"
          },
          "gpu_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gpu Id"
          }
        },
        "type": "object",
        "required": [
          "device_name",
          "full_device_name",
          "device_type",
          "device_family",
          "gpu_id"
        ],
        "title": "Device",
        "description": "**Hardware device description used by multiple APIs.**\n\nThis model is a simplified view of the device information returned\nby the runtime (e.g., OpenVINO) and is suitable for UI consumption.\n\n## Attributes\n- `device_name` - Short identifier used when selecting the device (e.g., \"CPU\", \"GPU\", \"GPU.0\", \"NPU\")\n- `full_device_name` - Human readable device name (CPU/GPU/NPU model)\n- `device_type` - High level device type (INTEGRATED or DISCRETE)\n- `device_family` - Hardware family (CPU, GPU, NPU)\n- `gpu_id` - Optional GPU index when applicable; null for non-GPU devices\n\n### Example\n```json\n{\n  \"device_name\": \"GPU.0\",\n  \"full_device_name\": \"Intel(R) Arc(TM) Graphics (iGPU) (GPU.0)\",\n  \"device_type\": \"INTEGRATED\",\n  \"device_family\": \"GPU\",\n  \"gpu_id\": 0\n}\n```"
      },
      "DeviceFamily": {
        "type": "string",
        "enum": [
          "CPU",
          "GPU",
          "NPU"
        ],
        "title": "DeviceFamily",
        "description": "**Hardware family of a device used for inference.**\n\n## Values\n- `CPU` - Central Processing Unit\n- `GPU` - Graphics Processing Unit\n- `NPU` - Neural Processing Unit / AI accelerator\n\n### Example\n```json\n\"CPU\"\n```"
      },
      "DeviceType": {
        "type": "string",
        "enum": [
          "DISCRETE",
          "INTEGRATED"
        ],
        "title": "DeviceType",
        "description": "**High level type of hardware device.**\n\n## Values\n- `DISCRETE` - Standalone accelerator board (for example a dedicated GPU)\n- `INTEGRATED` - Device integrated into CPU or SoC\n\n### Example\n```json\n\"DISCRETE\"\n```"
      },
      "Edge": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "source": {
            "type": "string",
            "title": "Source"
          },
          "target": {
            "type": "string",
            "title": "Target"
          }
        },
        "type": "object",
        "required": [
          "id",
          "source",
          "target"
        ],
        "title": "Edge",
        "description": "**Directed connection between two nodes in a generic pipeline graph.**\n\n## Attributes\n- `id` - Edge identifier, unique within a single graph\n- `source` - ID of the source node\n- `target` - ID of the target node"
      },
      "ExecutionConfig": {
        "properties": {
          "output_mode": {
            "$ref": "#/components/schemas/OutputMode",
            "description": "Mode for pipeline output generation.",
            "default": "disabled"
          },
          "max_runtime": {
            "type": "number",
            "minimum": 0.0,
            "title": "Max Runtime",
            "description": "Maximum runtime in seconds (0 = run until EOS, >0 = time limit with looping for live_stream/disabled).",
            "default": 0.0
          },
          "metadata_mode": {
            "$ref": "#/components/schemas/MetadataMode",
            "description": "Metadata publishing mode. 'disabled' (default): no metadata produced. 'file': gvametapublish elements write JSON-Lines metadata, available via SSE endpoints.",
            "default": "disabled"
          }
        },
        "type": "object",
        "title": "ExecutionConfig",
        "description": "**Configuration for pipeline execution behavior.**\n\nThis configuration controls output generation, runtime limits, and\nmetadata publishing for test pipelines.\n\n## Attributes\n- `output_mode` - Mode for pipeline output generation:\n  - `disabled` - No output (fakesink remains, default)\n  - `file` - Save video to file (only allowed with max_runtime=0)\n  - `live_stream` - Stream output live to media server\n- `max_runtime` - Maximum runtime in seconds for the pipeline:\n  - 0: Run until natural completion (EOS), no time limit (default)\n  - >0: Stop pipeline after this duration, with looping if EOS comes early (only allowed with output_mode=disabled or output_mode=live_stream)\n  - <0: Not allowed (will be rejected)\n- `metadata_mode` - Mode for metadata publishing via `gvametapublish` elements present in the pipeline:\n  - `disabled` - No metadata file paths are injected; gvametapublish elements remain unchanged (default)\n  - `file` - gvametapublish elements write JSON-Lines metadata, available via SSE endpoints\n\n### Example (disabled output, no runtime limit)\n```json\n{\n  \"output_mode\": \"disabled\",\n  \"max_runtime\": 0\n}\n```\n\n### Example (save to file, run until EOS)\n```json\n{\n  \"output_mode\": \"file\",\n  \"max_runtime\": 0\n}\n```\n\n### Example (live streaming with 60 second limit)\n```json\n{\n  \"output_mode\": \"live_stream\",\n  \"max_runtime\": 60\n}\n```\n\n### Example (metadata publishing to file)\n```json\n{\n  \"output_mode\": \"disabled\",\n  \"max_runtime\": 0,\n  \"metadata_mode\": \"file\"\n}\n```"
      },
      "GraphInline": {
        "properties": {
          "source": {
            "type": "string",
            "const": "graph",
            "title": "Source",
            "default": "graph"
          },
          "graph_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Graph Id",
            "description": "Optional custom identifier for inline graph. Must be URL-safe.",
            "examples": [
              "my-custom-pipeline",
              "detection-gpu-v2"
            ]
          },
          "pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Inline pipeline graph to use for the test."
          }
        },
        "type": "object",
        "required": [
          "pipeline_graph"
        ],
        "title": "GraphInline",
        "description": "**Inline pipeline graph definition.**\n\nUsed when specifying a pipeline for tests by providing the graph\ndirectly instead of referencing an existing variant.\n\n## Attributes\n- `source` - Discriminator field, always \"graph\" for this type\n- `pipeline_graph` - Complete pipeline graph to use\n- `graph_id` - Optional custom identifier for this inline graph (if provided, used instead of generating a hash-based ID; must be URL-safe with only lowercase letters, numbers, and dashes; if not provided, synthetic ID generated from graph content hash)\n\n### Example (without graph_id - uses generated hash)\n```json\n{\n  \"source\": \"graph\",\n  \"pipeline_graph\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  }\n}\n```\n\n### Example (with custom graph_id)\n```json\n{\n  \"source\": \"graph\",\n  \"graph_id\": \"my-custom-pipeline\",\n  \"pipeline_graph\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  }\n}\n```"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "HealthResponse": {
        "properties": {
          "healthy": {
            "type": "boolean",
            "title": "Healthy"
          }
        },
        "type": "object",
        "required": [
          "healthy"
        ],
        "title": "HealthResponse",
        "description": "**Response model for health endpoint.**\n\nUsed by Docker healthcheck and monitoring systems to verify\napplication health status.\n\n## Attributes\n- `healthy` - True if application is healthy (not shutdown)\n\n### Example\n```json\n{\n  \"healthy\": true\n}\n```"
      },
      "MessageResponse": {
        "properties": {
          "message": {
            "type": "string",
            "title": "Message",
            "description": "Human-readable error or status message.",
            "examples": [
              "Job job123 not found",
              "Unexpected error while discovering devices."
            ]
          }
        },
        "type": "object",
        "required": [
          "message"
        ],
        "title": "MessageResponse",
        "description": "**Generic message payload used as a simple response body.**\n\nThis model is used mainly for non-2xx responses to provide a plain\nEnglish description of what happened (error or informational status).\n\n## Attributes\n- `message` - Human-readable error or status message\n\n### Example\n```json\n{\n  \"message\": \"Performance job job123 not found\"\n}\n```"
      },
      "MetadataMode": {
        "type": "string",
        "enum": [
          "disabled",
          "file"
        ],
        "title": "MetadataMode",
        "description": "**Mode for pipeline metadata publishing via gvametapublish elements.**\n\nControls whether and how inference metadata produced by `gvametapublish`\nelements in the pipeline is published.\n\n## Values\n- `DISABLED` - No metadata file paths are injected; gvametapublish elements remain unchanged (default)\n- `FILE` - gvametapublish elements write JSON-Lines metadata, available via SSE endpoints\n\n### Example\n```json\n\"file\"\n```"
      },
      "Model": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "display_name": {
            "type": "string",
            "title": "Display Name"
          },
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ModelCategory"
              },
              {
                "type": "null"
              }
            ]
          },
          "precision": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Precision"
          }
        },
        "type": "object",
        "required": [
          "name",
          "display_name",
          "category",
          "precision"
        ],
        "title": "Model",
        "description": "**Description of a single model exposed by the models API.**\n\n## Attributes\n- `name` - Internal model identifier used by the backend\n- `display_name` - Human readable model name suitable for UI\n- `category` - Logical model category (classification, detection), or null when the type from configuration is unknown or unsupported\n- `precision` - Model precision string (e.g., \"FP32\", \"INT8\"), or null when not specified\n\n### Example\n```json\n{\n  \"name\": \"vehicle-detection-0202\",\n  \"display_name\": \"Vehicle Detection\",\n  \"category\": \"detection\",\n  \"precision\": \"FP32\"\n}\n```"
      },
      "ModelCategory": {
        "type": "string",
        "enum": [
          "classification",
          "detection"
        ],
        "title": "ModelCategory",
        "description": "**Model category for classification or detection tasks.**\n\n## Values\n- `CLASSIFICATION` - Classification model\n- `DETECTION` - Detection model\n\n### Example\n```json\n\"detection\"\n```"
      },
      "NetworkCameraDetails": {
        "properties": {
          "ip": {
            "type": "string",
            "title": "Ip"
          },
          "port": {
            "type": "integer",
            "title": "Port"
          },
          "profiles": {
            "items": {
              "$ref": "#/components/schemas/CameraProfileInfo"
            },
            "type": "array",
            "title": "Profiles"
          },
          "best_profile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CameraProfileInfo"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "ip",
          "port",
          "profiles"
        ],
        "title": "NetworkCameraDetails",
        "description": "**Network camera details including ONVIF profiles and best profile.**\n\nThe best profile is selected by the scoring algorithm.\n\n## Attributes\n- `ip` - IP address of the camera\n- `port` - Port number for ONVIF communication\n- `profiles` - List of ONVIF profiles available on this camera (populated after authentication)\n- `best_profile` - Best profile selected by scoring algorithm (optional)"
      },
      "Node": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "data": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Data"
          }
        },
        "type": "object",
        "required": [
          "id",
          "type",
          "data"
        ],
        "title": "Node",
        "description": "**Single node in a generic pipeline graph.**\n\n## Attributes\n- `id` - Node identifier, unique within a single graph\n- `type` - Element type, usually a framework-specific element name (e.g., GStreamer element)\n- `data` - Key/value properties for the element (e.g., element arguments or configuration)\n  - Reserved key: `__node_kind__` - Optional internal discriminator for special node types. When equal to \"caps\", represents a GStreamer caps string (e.g., \"video/x-raw,width=320,height=240\") instead of a regular element. Stored in `data` to avoid breaking existing API contracts."
      },
      "OptimizationJobResponse": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id",
            "description": "Identifier of the created optimization job.",
            "examples": [
              "opt789"
            ]
          }
        },
        "type": "object",
        "required": [
          "job_id"
        ],
        "title": "OptimizationJobResponse",
        "description": "**Simple envelope with a new optimization job identifier.**\n\nUsed as response body when an optimization job is created.\n\n## Attributes\n- `job_id` - Identifier of the created optimization job\n\n### Example\n```json\n{\n  \"job_id\": \"opt789\"\n}\n```"
      },
      "OptimizationJobState": {
        "type": "string",
        "enum": [
          "RUNNING",
          "COMPLETED",
          "FAILED"
        ],
        "title": "OptimizationJobState",
        "description": "**Generic state of an optimization job.**\n\n## Values\n- `RUNNING` - Optimization is in progress\n- `COMPLETED` - Optimization finished successfully\n- `FAILED` - Optimization finished unsuccessfully\n\n### Example\n```json\n\"RUNNING\"\n```"
      },
      "OptimizationJobStatus": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "type": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OptimizationType"
              },
              {
                "type": "null"
              }
            ]
          },
          "start_time": {
            "type": "integer",
            "title": "Start Time"
          },
          "elapsed_time": {
            "type": "integer",
            "title": "Elapsed Time"
          },
          "state": {
            "$ref": "#/components/schemas/OptimizationJobState"
          },
          "details": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Details"
          },
          "total_fps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Fps"
          },
          "original_pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph"
          },
          "original_pipeline_graph_simple": {
            "$ref": "#/components/schemas/PipelineGraph"
          },
          "optimized_pipeline_graph": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PipelineGraph"
              },
              {
                "type": "null"
              }
            ]
          },
          "optimized_pipeline_graph_simple": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PipelineGraph"
              },
              {
                "type": "null"
              }
            ]
          },
          "original_pipeline_description": {
            "type": "string",
            "title": "Original Pipeline Description"
          },
          "optimized_pipeline_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Optimized Pipeline Description"
          }
        },
        "type": "object",
        "required": [
          "id",
          "type",
          "start_time",
          "elapsed_time",
          "state",
          "details",
          "total_fps",
          "original_pipeline_graph",
          "original_pipeline_graph_simple",
          "optimized_pipeline_graph",
          "optimized_pipeline_graph_simple",
          "original_pipeline_description",
          "optimized_pipeline_description"
        ],
        "title": "OptimizationJobStatus",
        "description": "**Detailed status of an optimization job.**\n\n## Attributes\n- `id` - Job identifier\n- `type` - Optimization type (PREPROCESS or OPTIMIZE)\n- `start_time` - Start time in milliseconds since epoch\n- `elapsed_time` - Elapsed time in milliseconds\n- `state` - Current job state\n- `details` - List of human-readable messages explaining why the job reached its current state. Cleared when the job transitions to a new state, then new entries are appended. Cancellation always results in FAILED state. Examples: [\"Optimization completed successfully\"], [\"Cancelled by user\"], [\"Optimization failed: ...\"]\n- `total_fps` - Measured FPS for optimized pipeline (for OPTIMIZE)\n- `original_pipeline_graph` - Original pipeline graph (advanced view) before optimization\n- `original_pipeline_graph_simple` - Original pipeline graph (simple view) before optimization\n- `optimized_pipeline_graph` - Optimized pipeline graph (advanced view) if available\n- `optimized_pipeline_graph_simple` - Optimized pipeline graph (simple view) if available\n- `original_pipeline_description` - Original GStreamer pipeline string before optimization\n- `optimized_pipeline_description` - Optimized GStreamer pipeline string after optimization (if any)"
      },
      "OptimizationJobSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "request": {
            "$ref": "#/components/schemas/PipelineRequestOptimize"
          }
        },
        "type": "object",
        "required": [
          "id",
          "request"
        ],
        "title": "OptimizationJobSummary",
        "description": "**Short summary for an optimization job.**\n\n## Attributes\n- `id` - Job identifier\n- `request` - Original PipelineRequestOptimize used to start the job\n\n### Example\n```json\n{\n  \"id\": \"opt789\",\n  \"request\": {\n    \"type\": \"optimize\",\n    \"parameters\": {}\n  }\n}\n```"
      },
      "OptimizationType": {
        "type": "string",
        "enum": [
          "preprocess",
          "optimize"
        ],
        "title": "OptimizationType",
        "description": "**Type of optimization operation.**\n\n## Values\n- `PREPROCESS` - Run only preprocessing\n- `OPTIMIZE` - Run full optimization with search/sampling\n\n### Example\n```json\n\"optimize\"\n```"
      },
      "OutputMode": {
        "type": "string",
        "enum": [
          "disabled",
          "file",
          "live_stream"
        ],
        "title": "OutputMode",
        "description": "**Mode for pipeline output generation.**\n\n## Values\n- `DISABLED` - No output generation (default)\n- `FILE` - Save output to file\n- `LIVE_STREAM` - Stream output live to media server\n\n### Example\n```json\n\"disabled\"\n```"
      },
      "PerformanceJobStatus": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "start_time": {
            "type": "integer",
            "title": "Start Time"
          },
          "elapsed_time": {
            "type": "integer",
            "title": "Elapsed Time"
          },
          "state": {
            "$ref": "#/components/schemas/TestJobState"
          },
          "details": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Details"
          },
          "total_fps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Fps"
          },
          "per_stream_fps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Per Stream Fps"
          },
          "total_streams": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Streams"
          },
          "streams_per_pipeline": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/PipelineStreamSpec"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Streams Per Pipeline"
          },
          "video_output_paths": {
            "anyOf": [
              {
                "additionalProperties": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Video Output Paths"
          },
          "live_stream_urls": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Live Stream Urls"
          },
          "metadata_stream_urls": {
            "anyOf": [
              {
                "additionalProperties": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Metadata Stream Urls"
          }
        },
        "type": "object",
        "required": [
          "id",
          "start_time",
          "elapsed_time",
          "state",
          "details",
          "total_fps",
          "per_stream_fps",
          "total_streams",
          "streams_per_pipeline",
          "video_output_paths",
          "live_stream_urls",
          "metadata_stream_urls"
        ],
        "title": "PerformanceJobStatus",
        "description": "**Status of a performance test job.**\n\nInherits all fields from TestsJobStatus and adds live_stream_urls and\nmetadata_stream_urls for live-streaming output mode support.\n\n## Attributes\n- *Inherited from TestsJobStatus* - id, start_time, elapsed_time, state, details, total_fps, per_stream_fps, total_streams, streams_per_pipeline, video_output_paths\n- `live_stream_urls` - Mapping from pipeline id to live stream URL when using live_stream output mode (keys use the same id format as streams_per_pipeline entries; only available for performance tests)\n- `metadata_stream_urls` - Mapping from pipeline id to list of SSE endpoint URLs for streaming live metadata records, one URL per gvametapublish file (null when the pipeline does not include a gvametapublish element writing to a file; URL index corresponds to file_index path parameter)"
      },
      "PerformanceJobSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "request": {
            "additionalProperties": true,
            "type": "object",
            "title": "Request"
          }
        },
        "type": "object",
        "required": [
          "id",
          "request"
        ],
        "title": "PerformanceJobSummary",
        "description": "**Short summary for a performance test job.**\n\n## Attributes\n- `id` - Job identifier\n- `request` - Original PerformanceTestSpec used to start the job (stored as dict and validated on output)\n\n### Example\n```json\n{\n  \"id\": \"job123\",\n  \"request\": {\n    \"pipeline_performance_specs\": [...],\n    \"execution_config\": {...}\n  }\n}\n```"
      },
      "PerformanceTestSpec": {
        "properties": {
          "pipeline_performance_specs": {
            "items": {
              "$ref": "#/components/schemas/PipelinePerformanceSpec"
            },
            "type": "array",
            "title": "Pipeline Performance Specs",
            "description": "List of pipelines with number of streams for each.",
            "examples": [
              [
                {
                  "pipeline": {
                    "pipeline_id": "pipeline-a3f5d9e1",
                    "source": "variant",
                    "variant_id": "variant-abc123"
                  },
                  "streams": 4
                }
              ]
            ]
          },
          "execution_config": {
            "$ref": "#/components/schemas/ExecutionConfig",
            "description": "Execution configuration for output and runtime.",
            "default": {
              "output_mode": "disabled",
              "max_runtime": 0.0,
              "metadata_mode": "disabled"
            },
            "examples": [
              {
                "max_runtime": 0,
                "metadata_mode": "disabled",
                "output_mode": "disabled"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline_performance_specs"
        ],
        "title": "PerformanceTestSpec",
        "description": "**Request body for starting a performance test.**\n\n## Attributes\n- `pipeline_performance_specs` - List of pipelines and their stream counts\n- `execution_config` - Configuration for output generation, metadata publishing and runtime limits\n\n### Example\n```json\n{\n  \"pipeline_performance_specs\": [\n    {\n      \"pipeline\": {\n        \"source\": \"variant\",\n        \"pipeline_id\": \"pipeline-a3f5d9e1\",\n        \"variant_id\": \"variant-abc123\"\n      },\n      \"streams\": 4\n    }\n  ],\n  \"execution_config\": {\n    \"output_mode\": \"disabled\",\n    \"max_runtime\": 0,\n    \"metadata_mode\": \"disabled\"\n  }\n}\n```"
      },
      "Pipeline": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "type": "string",
            "title": "Description"
          },
          "source": {
            "$ref": "#/components/schemas/PipelineSource"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags",
            "description": "List of tags for categorizing the pipeline.",
            "default": []
          },
          "variants": {
            "items": {
              "$ref": "#/components/schemas/Variant"
            },
            "type": "array",
            "minItems": 1,
            "title": "Variants",
            "description": "List of pipeline variants for different hardware targets."
          },
          "thumbnail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnail",
            "description": "Base64-encoded thumbnail image. Only for PREDEFINED pipelines. Redacted in logs."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation timestamp as UTC datetime. Set by backend only."
          },
          "modified_at": {
            "type": "string",
            "format": "date-time",
            "title": "Modified At",
            "description": "Last modification timestamp as UTC datetime. Set by backend only."
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "description",
          "source",
          "variants",
          "created_at",
          "modified_at"
        ],
        "title": "Pipeline",
        "description": "**Full pipeline definition exposed by the pipelines API.**\n\n## Attributes\n- `id` - Unique pipeline identifier generated by the backend\n- `name` - Logical pipeline name\n- `description` - Human-readable text describing what the pipeline does\n- `source` - Origin of the pipeline (PREDEFINED or USER_CREATED)\n- `tags` - List of tags for categorizing the pipeline\n- `variants` - List of pipeline variants for different hardware targets (each variant has its own pipeline_graph and pipeline_graph_simple)\n- `thumbnail` - Base64-encoded image for pipeline preview (only available for PREDEFINED pipelines with valid thumbnail file; redacted when printing)\n- `created_at` - Creation timestamp as UTC datetime (set by backend only, not modifiable via API)\n- `modified_at` - Last modification timestamp as UTC datetime (updated when pipeline or its variants are modified; set by backend only)\n\n### Example\n```json\n{\n  \"id\": \"pipeline-a3f5d9e1\",\n  \"name\": \"vehicle-detection\",\n  \"description\": \"Simple vehicle detection pipeline\",\n  \"source\": \"USER_CREATED\",\n  \"tags\": [\"detection\", \"vehicle\"],\n  \"variants\": [\n    {\n      \"id\": \"variant-1\",\n      \"name\": \"CPU\",\n      \"read_only\": false,\n      \"pipeline_graph\": {...},\n      \"pipeline_graph_simple\": {...},\n      \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n      \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n    }\n  ],\n  \"thumbnail\": null,\n  \"created_at\": \"2026-02-05T14:30:45.123000+00:00\",\n  \"modified_at\": \"2026-02-05T14:30:45.123000+00:00\"\n}\n```"
      },
      "PipelineCreationResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          }
        },
        "type": "object",
        "required": [
          "id"
        ],
        "title": "PipelineCreationResponse",
        "description": "**Response body returned after a new pipeline is created.**\n\n## Attributes\n- `id` - Identifier of the created pipeline\n\n### Example\n```json\n{\n  \"id\": \"pipeline-a3f5d9e1\"\n}\n```"
      },
      "PipelineDefinition": {
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "title": "Name",
            "description": "Non-empty pipeline name."
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "title": "Description",
            "description": "Non-empty human-readable text describing what the pipeline does."
          },
          "source": {
            "$ref": "#/components/schemas/PipelineSource",
            "default": "USER_CREATED"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags",
            "description": "List of tags for categorizing the pipeline.",
            "default": []
          },
          "variants": {
            "items": {
              "$ref": "#/components/schemas/VariantCreate"
            },
            "type": "array",
            "minItems": 1,
            "title": "Variants",
            "description": "List of pipeline variants for different hardware targets."
          }
        },
        "type": "object",
        "required": [
          "name",
          "description",
          "variants"
        ],
        "title": "PipelineDefinition",
        "description": "**Input model used to create a new pipeline via the API.**\n\n## Attributes\n- `name` - Non-empty pipeline name\n- `description` - Non-empty human-readable text describing what the pipeline does\n- `source` - Pipeline source (for create endpoint this value is overwritten to USER_CREATED)\n- `tags` - List of tags for categorizing the pipeline\n- `variants` - List of pipeline variants for different hardware targets (each variant requires name, pipeline_graph, and pipeline_graph_simple)\n\n### Example\n```json\n{\n  \"name\": \"vehicle-detection\",\n  \"description\": \"Simple vehicle detection pipeline\",\n  \"tags\": [\"detection\", \"vehicle\"],\n  \"variants\": [\n    {\n      \"name\": \"CPU\",\n      \"pipeline_graph\": {...},\n      \"pipeline_graph_simple\": {...}\n    }\n  ]\n}\n```"
      },
      "PipelineDensitySpec": {
        "properties": {
          "pipeline": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/VariantReference"
              },
              {
                "$ref": "#/components/schemas/GraphInline"
              },
              {
                "$ref": "#/components/schemas/PipelineDescriptionSource"
              }
            ],
            "title": "Pipeline",
            "description": "Graph source - either a reference to existing variant or inline graph.",
            "discriminator": {
              "propertyName": "source",
              "mapping": {
                "description": "#/components/schemas/PipelineDescriptionSource",
                "graph": "#/components/schemas/GraphInline",
                "variant": "#/components/schemas/VariantReference"
              }
            }
          },
          "stream_rate": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Stream Rate",
            "description": "Relative share of total streams for this pipeline (percentage).",
            "default": 100,
            "examples": [
              50
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline"
        ],
        "title": "PipelineDensitySpec",
        "description": "**Per-pipeline configuration for density tests.**\n\nThe pipeline can be specified in two ways:\n- `variant` - Reference to an existing pipeline variant by pipeline_id and variant_id\n- `graph` - Inline pipeline graph provided directly\n\nUsed in DensityTestSpec to describe how total streams are split between\npipelines based on relative ratios.\n\n## Attributes\n- `pipeline` - Graph source (either a reference to existing variant or inline graph; discriminated by 'source' field: \"variant\" or \"graph\")\n- `stream_rate` - Relative share of total streams for this pipeline expressed as percentage (all stream_rate values in the request must sum to 100)\n\n### Example (Variant reference)\n```json\n{\n  \"pipeline\": {\n    \"source\": \"variant\",\n    \"pipeline_id\": \"pipeline-a3f5d9e1\",\n    \"variant_id\": \"variant-abc123\"\n  },\n  \"stream_rate\": 50\n}\n```\n\n### Example (Inline graph)\n```json\n{\n  \"pipeline\": {\n    \"source\": \"graph\",\n    \"pipeline_graph\": {\n      \"nodes\": [...],\n      \"edges\": [...]\n    }\n  },\n  \"stream_rate\": 50\n}\n```"
      },
      "PipelineDescription": {
        "properties": {
          "pipeline_description": {
            "type": "string",
            "title": "Pipeline Description",
            "description": "GStreamer pipeline string with elements separated by '!'.",
            "examples": [
              "videotestsrc ! videoconvert ! autovideosink"
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline_description"
        ],
        "title": "PipelineDescription",
        "description": "**Request or response body containing a GStreamer pipeline string.**\n\nThe pipeline_description field contains a complete GStreamer launch line\nwith elements separated by '!' symbols.\n\n## Attributes\n- `pipeline_description` - Complete GStreamer pipeline string to be converted or executed (elements separated by '!')\n\n### Example\n```json\n{\n  \"pipeline_description\": \"filesrc location=input.mp4 ! decodebin ! videoconvert ! autovideosink\"\n}\n```"
      },
      "PipelineDescriptionSource": {
        "properties": {
          "source": {
            "type": "string",
            "const": "description",
            "title": "Source",
            "default": "description"
          },
          "pipeline_description": {
            "type": "string",
            "minLength": 1,
            "title": "Pipeline Description",
            "description": "GStreamer pipeline string with elements separated by '!'.",
            "examples": [
              "videotestsrc ! videoconvert ! fakesink"
            ]
          },
          "description_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description Id",
            "description": "Optional custom identifier for pipeline description. Must be URL-safe.",
            "examples": [
              "my-test-pipeline",
              "detection-cpu-v1"
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline_description"
        ],
        "title": "PipelineDescriptionSource",
        "description": "**Pipeline source from GStreamer pipeline description string.**\n\nUsed when specifying a pipeline for tests by providing a GStreamer\npipeline description string that will be parsed into a graph.\n\n## Attributes\n- `source` - Discriminator field, always \"description\" for this type\n- `pipeline_description` - GStreamer pipeline string with elements separated by '!' (must be non-empty)\n- `description_id` - Optional custom identifier for this pipeline description (if provided, used instead of generating a hash-based ID; must be URL-safe with only lowercase letters, numbers, and dashes; if not provided, synthetic ID generated from description content hash)\n\n### Example (without description_id - uses generated hash)\n```json\n{\n  \"source\": \"description\",\n  \"pipeline_description\": \"videotestsrc ! videoconvert ! fakesink\"\n}\n```\n\n### Example (with custom description_id)\n```json\n{\n  \"source\": \"description\",\n  \"description_id\": \"my-test-pipeline\",\n  \"pipeline_description\": \"videotestsrc ! videoconvert ! fakesink\"\n}\n```"
      },
      "PipelineGraph": {
        "properties": {
          "nodes": {
            "items": {
              "$ref": "#/components/schemas/Node"
            },
            "type": "array",
            "title": "Nodes",
            "description": "List of pipeline nodes.",
            "examples": [
              [
                {
                  "data": {},
                  "id": "0",
                  "type": "videotestsrc"
                },
                {
                  "data": {},
                  "id": "1",
                  "type": "videoconvert"
                },
                {
                  "data": {},
                  "id": "2",
                  "type": "autovideosink"
                }
              ]
            ]
          },
          "edges": {
            "items": {
              "$ref": "#/components/schemas/Edge"
            },
            "type": "array",
            "title": "Edges",
            "description": "List of directed edges between nodes.",
            "examples": [
              [
                {
                  "id": "0",
                  "source": "0",
                  "target": "1"
                },
                {
                  "id": "1",
                  "source": "1",
                  "target": "2"
                }
              ]
            ]
          }
        },
        "type": "object",
        "required": [
          "nodes",
          "edges"
        ],
        "title": "PipelineGraph",
        "description": "**Request or response body containing the structured pipeline graph.**\n\nThis is a generic representation used by multiple endpoints\n(conversion, validation, optimization).\n\n## Attributes\n- `nodes` - List of graph nodes\n- `edges` - Directed connections between nodes"
      },
      "PipelineGraphResponse": {
        "properties": {
          "pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Advanced graph view with all pipeline elements including technical plumbing."
          },
          "pipeline_graph_simple": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Simplified graph view showing only sources, inference nodes, and sinks."
          }
        },
        "type": "object",
        "required": [
          "pipeline_graph",
          "pipeline_graph_simple"
        ],
        "title": "PipelineGraphResponse",
        "description": "**Response body containing both advanced and simple views of a pipeline graph.**\n\nUsed by the /convert/to-graph endpoint to return both representations\nat once.\n\n## Attributes\n- `pipeline_graph` - Advanced view with all technical elements including queues, converters, caps nodes, and other plumbing elements. Contains the complete pipeline structure as parsed from the pipeline description\n- `pipeline_graph_simple` - Simplified view showing only meaningful elements such as sources, inference nodes (gva*), and sinks. Technical plumbing elements are hidden and edges are reconnected to show direct connections between visible nodes\n\n### Example\n```json\n{\n  \"pipeline_graph\": {\n    \"nodes\": [\n      {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"input.mp4\"}},\n      {\"id\": \"1\", \"type\": \"decodebin\", \"data\": {}},\n      {\"id\": \"2\", \"type\": \"queue\", \"data\": {}},\n      {\"id\": \"3\", \"type\": \"gvadetect\", \"data\": {\"model\": \"yolo\"}},\n      {\"id\": \"4\", \"type\": \"fakesink\", \"data\": {}}\n    ],\n    \"edges\": [\n      {\"id\": \"0\", \"source\": \"0\", \"target\": \"1\"},\n      {\"id\": \"1\", \"source\": \"1\", \"target\": \"2\"},\n      {\"id\": \"2\", \"source\": \"2\", \"target\": \"3\"},\n      {\"id\": \"3\", \"source\": \"3\", \"target\": \"4\"}\n    ]\n  },\n  \"pipeline_graph_simple\": {\n    \"nodes\": [\n      {\"id\": \"0\", \"type\": \"filesrc\", \"data\": {\"location\": \"input.mp4\"}},\n      {\"id\": \"3\", \"type\": \"gvadetect\", \"data\": {\"model\": \"yolo\"}},\n      {\"id\": \"4\", \"type\": \"fakesink\", \"data\": {}}\n    ],\n    \"edges\": [\n      {\"id\": \"0\", \"source\": \"0\", \"target\": \"3\"},\n      {\"id\": \"1\", \"source\": \"3\", \"target\": \"4\"}\n    ]\n  }\n}\n```"
      },
      "PipelinePerformanceSpec": {
        "properties": {
          "pipeline": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/VariantReference"
              },
              {
                "$ref": "#/components/schemas/GraphInline"
              },
              {
                "$ref": "#/components/schemas/PipelineDescriptionSource"
              }
            ],
            "title": "Pipeline",
            "description": "Graph source - either a reference to existing variant or inline graph.",
            "discriminator": {
              "propertyName": "source",
              "mapping": {
                "description": "#/components/schemas/PipelineDescriptionSource",
                "graph": "#/components/schemas/GraphInline",
                "variant": "#/components/schemas/VariantReference"
              }
            }
          },
          "streams": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Streams",
            "description": "Number of parallel streams for this pipeline.",
            "default": 1,
            "examples": [
              1,
              4,
              16
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline"
        ],
        "title": "PipelinePerformanceSpec",
        "description": "**Per-pipeline configuration for performance and density tests.**\n\nThe pipeline can be specified in two ways:\n- `variant` - Reference to an existing pipeline variant by pipeline_id and variant_id\n- `graph` - Inline pipeline graph provided directly\n\n## Attributes\n- `pipeline` - Graph source (either a reference to existing variant or inline graph; discriminated by 'source' field: \"variant\" or \"graph\")\n- `streams` - Number of parallel streams to run for this pipeline\n\n### Example (Variant reference)\n```json\n{\n  \"pipeline\": {\n    \"source\": \"variant\",\n    \"pipeline_id\": \"pipeline-a3f5d9e1\",\n    \"variant_id\": \"variant-abc123\"\n  },\n  \"streams\": 4\n}\n```\n\n### Example (Inline graph)\n```json\n{\n  \"pipeline\": {\n    \"source\": \"graph\",\n    \"pipeline_graph\": {\n      \"nodes\": [...],\n      \"edges\": [...]\n    }\n  },\n  \"streams\": 4\n}\n```"
      },
      "PipelineRequestOptimize": {
        "properties": {
          "type": {
            "$ref": "#/components/schemas/OptimizationType"
          },
          "parameters": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parameters"
          }
        },
        "type": "object",
        "required": [
          "type",
          "parameters"
        ],
        "title": "PipelineRequestOptimize",
        "description": "**Request body for starting a pipeline optimization job.**\n\n## Attributes\n- `type` - Optimization type: `preprocess` (run only preprocessing) or `optimize` (run full optimization with search/sampling)\n- `parameters` - Optional dictionary with optimizer-specific settings\n\n### Example\n```json\n{\n  \"type\": \"optimize\",\n  \"parameters\": {\n    \"search_duration\": 300,\n    \"sample_duration\": 10\n  }\n}\n```"
      },
      "PipelineSource": {
        "type": "string",
        "enum": [
          "PREDEFINED",
          "USER_CREATED",
          "TEMPLATE"
        ],
        "title": "PipelineSource",
        "description": "**Source of a pipeline definition.**\n\n## Values\n- `PREDEFINED` - Pipeline is predefined by the system\n- `USER_CREATED` - Pipeline was created by the user\n- `TEMPLATE` - Pipeline is a template\n\n### Example\n```json\n\"USER_CREATED\"\n```"
      },
      "PipelineStreamSpec": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Pipeline identifier - variant path or synthetic graph ID.",
            "examples": [
              "/pipelines/pipeline-a3f5d9e1/variants/variant-abc123",
              "__graph-1a2b3c4d5e6f7g8h"
            ]
          },
          "streams": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Streams",
            "description": "Number of streams allocated to this pipeline.",
            "examples": [
              4
            ]
          }
        },
        "type": "object",
        "required": [
          "id",
          "streams"
        ],
        "title": "PipelineStreamSpec",
        "description": "**Simple representation of pipeline stream count with pipeline identifier.**\n\nUsed in test job results to report which pipelines were executed and how many\nstreams were allocated to each.\n\nThe id field format depends on the pipeline source:\n- For variant reference: \"/pipelines/{pipeline_id}/variants/{variant_id}\"\n- For inline graph: \"__graph-{16-char-hash}\"\n\n## Attributes\n- `id` - Pipeline identifier (either variant path or synthetic graph ID)\n- `streams` - Number of streams allocated to this pipeline\n\n### Example (Variant reference)\n```json\n{\n  \"id\": \"/pipelines/pipeline-a3f5d9e1/variants/variant-abc123\",\n  \"streams\": 4\n}\n```\n\n### Example (Inline graph)\n```json\n{\n  \"id\": \"__graph-1a2b3c4d5e6f7g8h\",\n  \"streams\": 2\n}\n```"
      },
      "PipelineUpdate": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "tags": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tags"
          }
        },
        "type": "object",
        "title": "PipelineUpdate",
        "description": "**Partial update model for an existing pipeline.**\n\nAll fields are optional, but at least one must be provided when calling\nthe update endpoint. String fields (name, description) must be non-empty\nafter trimming whitespace.\n\nValidation is performed in model_validator to fail fast on invalid input.\n\n## Attributes\n- `name` - Optional new pipeline name (non-empty after trim if provided)\n- `description` - Optional new human-readable text describing what the pipeline does (non-empty after trim if provided)\n- `tags` - Optional list of tags (if provided, can be empty)\n\n### Example\n```json\n{\n  \"description\": \"Updated pipeline with better preprocessing\",\n  \"tags\": [\"updated\", \"v2\"]\n}\n```"
      },
      "PipelineValidation-Input": {
        "properties": {
          "pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph"
          },
          "parameters": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parameters",
            "examples": [
              {
                "max-runtime": 10
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline_graph"
        ],
        "title": "PipelineValidation",
        "description": "**Request body for pipeline validation.**\n\n## Attributes\n- `pipeline_graph` - Structured graph representation of the pipeline\n- `parameters` - Optional parameter set for validation (e.g., `{\"max-runtime\": 10}`)\n\n### Example\n```json\n{\n  \"pipeline_graph\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  },\n  \"parameters\": {\n    \"max-runtime\": 10\n  }\n}\n```"
      },
      "PipelineValidation-Output": {
        "properties": {
          "pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph"
          },
          "parameters": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parameters",
            "examples": [
              {
                "max-runtime": 10
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline_graph"
        ],
        "title": "PipelineValidation",
        "description": "**Request body for pipeline validation.**\n\n## Attributes\n- `pipeline_graph` - Structured graph representation of the pipeline\n- `parameters` - Optional parameter set for validation (e.g., `{\"max-runtime\": 10}`)\n\n### Example\n```json\n{\n  \"pipeline_graph\": {\n    \"nodes\": [...],\n    \"edges\": [...]\n  },\n  \"parameters\": {\n    \"max-runtime\": 10\n  }\n}\n```"
      },
      "StatusResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/AppStatus"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "ready": {
            "type": "boolean",
            "title": "Ready"
          }
        },
        "type": "object",
        "required": [
          "status",
          "message",
          "ready"
        ],
        "title": "StatusResponse",
        "description": "**Response model for status endpoint.**\n\nProvides detailed information about application initialization state\nand readiness to serve requests.\n\n## Attributes\n- `status` - Current application status (STARTING, INITIALIZING, READY, or SHUTDOWN)\n- `message` - Optional message describing current activity or initialization progress\n- `ready` - True if application is ready to serve API requests\n\n### Example\n```json\n{\n  \"status\": \"ready\",\n  \"message\": null,\n  \"ready\": true\n}\n```"
      },
      "TestJobResponse": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id",
            "description": "Identifier of the created test job.",
            "examples": [
              "job123"
            ]
          }
        },
        "type": "object",
        "required": [
          "job_id"
        ],
        "title": "TestJobResponse",
        "description": "**Simple envelope with a new test job identifier.**\n\nUsed as response body when performance or density test job is created.\n\n## Attributes\n- `job_id` - Identifier of the created test job\n\n### Example\n```json\n{\n  \"job_id\": \"job123\"\n}\n```"
      },
      "TestJobState": {
        "type": "string",
        "enum": [
          "RUNNING",
          "COMPLETED",
          "FAILED"
        ],
        "title": "TestJobState",
        "description": "**Generic state of a long-running test job (performance or density).**\n\n## Values\n- `RUNNING` - Job is still executing\n- `COMPLETED` - Job finished successfully\n- `FAILED` - Job finished unsuccessfully\n\n### Example\n```json\n\"RUNNING\"\n```"
      },
      "USBCameraDetails": {
        "properties": {
          "device_path": {
            "type": "string",
            "title": "Device Path"
          },
          "best_capture": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/V4L2BestCapture"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "device_path"
        ],
        "title": "USBCameraDetails",
        "description": "**USB camera details including the best capture configuration.**\n\nSelected by the scoring algorithm from available V4L2 formats.\n\n## Attributes\n- `device_path` - System device path (e.g., /dev/video0)\n- `best_capture` - Best capture configuration selected by scoring algorithm (optional)"
      },
      "V4L2BestCapture": {
        "properties": {
          "fourcc": {
            "type": "string",
            "title": "Fourcc"
          },
          "width": {
            "type": "integer",
            "title": "Width"
          },
          "height": {
            "type": "integer",
            "title": "Height"
          },
          "fps": {
            "type": "number",
            "title": "Fps"
          }
        },
        "type": "object",
        "required": [
          "fourcc",
          "width",
          "height",
          "fps"
        ],
        "title": "V4L2BestCapture",
        "description": "**Best capture configuration selected from available V4L2 formats.**\n\n## Attributes\n- `fourcc` - Selected pixel format four-character code\n- `width` - Selected resolution width in pixels\n- `height` - Selected resolution height in pixels\n- `fps` - Selected frame rate"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "ValidationJobResponse": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id",
            "description": "Identifier of the created validation job.",
            "examples": [
              "val001"
            ]
          }
        },
        "type": "object",
        "required": [
          "job_id"
        ],
        "title": "ValidationJobResponse",
        "description": "**Simple envelope with a new validation job identifier.**\n\nUsed as response body when a validation job is created.\n\n## Attributes\n- `job_id` - Identifier of the created validation job\n\n### Example\n```json\n{\n  \"job_id\": \"val001\"\n}\n```"
      },
      "ValidationJobState": {
        "type": "string",
        "enum": [
          "RUNNING",
          "COMPLETED",
          "FAILED"
        ],
        "title": "ValidationJobState",
        "description": "**Generic state of a validation job.**\n\n## Values\n- `RUNNING` - Validation is in progress\n- `COMPLETED` - Validation finished successfully (pipeline is valid)\n- `FAILED` - Validation finished unsuccessfully (pipeline is invalid, or encountered an error)\n\n### Example\n```json\n\"RUNNING\"\n```"
      },
      "ValidationJobStatus": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "start_time": {
            "type": "integer",
            "title": "Start Time"
          },
          "elapsed_time": {
            "type": "integer",
            "title": "Elapsed Time"
          },
          "state": {
            "$ref": "#/components/schemas/ValidationJobState"
          },
          "details": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Details"
          },
          "is_valid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Valid"
          }
        },
        "type": "object",
        "required": [
          "id",
          "start_time",
          "elapsed_time",
          "state",
          "details",
          "is_valid"
        ],
        "title": "ValidationJobStatus",
        "description": "**Detailed status of a validation job.**\n\n## Attributes\n- `id` - Job identifier\n- `start_time` - Start time in milliseconds since epoch\n- `elapsed_time` - Elapsed time in milliseconds\n- `state` - Current validation job state\n- `details` - List of human-readable messages explaining why the job reached its current state. Cleared when the job transitions to a new state, then new entries are appended. Examples: [\"Pipeline is valid\"], [\"Pipeline validation failed: no element foo\"]\n- `is_valid` - Final validation result (true/false) when completed"
      },
      "ValidationJobSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "request": {
            "$ref": "#/components/schemas/PipelineValidation-Output"
          }
        },
        "type": "object",
        "required": [
          "id",
          "request"
        ],
        "title": "ValidationJobSummary",
        "description": "**Short summary for a validation job.**\n\n## Attributes\n- `id` - Job identifier\n- `request` - Original PipelineValidation request\n\n### Example\n```json\n{\n  \"id\": \"val001\",\n  \"request\": {\n    \"pipeline_graph\": {...},\n    \"parameters\": {}\n  }\n}\n```"
      },
      "Variant": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Unique variant identifier generated by the backend."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "title": "Name",
            "description": "Variant name identifying the hardware target.",
            "examples": [
              "CPU",
              "GPU",
              "NPU"
            ]
          },
          "read_only": {
            "type": "boolean",
            "title": "Read Only",
            "description": "Whether the variant is read-only. Can only be true for PREDEFINED or TEMPLATE pipelines.",
            "default": false
          },
          "pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Advanced graph view with all pipeline elements for this variant."
          },
          "pipeline_graph_simple": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Simplified graph view for this variant."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation timestamp as UTC datetime. Set by backend only."
          },
          "modified_at": {
            "type": "string",
            "format": "date-time",
            "title": "Modified At",
            "description": "Last modification timestamp as UTC datetime. Set by backend only."
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "pipeline_graph",
          "pipeline_graph_simple",
          "created_at",
          "modified_at"
        ],
        "title": "Variant",
        "description": "**Single variant of a pipeline for different hardware targets.**\n\n## Attributes\n- `id` - Unique variant identifier generated by the backend (not used when creating or updating variants)\n- `name` - Variant name (e.g., \"CPU\", \"GPU\", \"NPU\")\n- `read_only` - Whether the variant is read-only (defaults to false, can only be true for PREDEFINED pipeline variants)\n- `pipeline_graph` - Advanced graph representation for this variant\n- `pipeline_graph_simple` - Simplified graph representation for this variant\n- `created_at` - Creation timestamp as UTC datetime (set by backend only, not modifiable via API)\n- `modified_at` - Last modification timestamp as UTC datetime (updated when variant is modified, set by backend only)"
      },
      "VariantCreate": {
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "title": "Name",
            "description": "Variant name identifying the hardware target.",
            "examples": [
              "CPU",
              "GPU",
              "NPU"
            ]
          },
          "pipeline_graph": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Advanced graph view with all pipeline elements for this variant."
          },
          "pipeline_graph_simple": {
            "$ref": "#/components/schemas/PipelineGraph",
            "description": "Simplified graph view for this variant."
          }
        },
        "type": "object",
        "required": [
          "name",
          "pipeline_graph",
          "pipeline_graph_simple"
        ],
        "title": "VariantCreate",
        "description": "**Input model for creating a new variant.**\n\nThe id and read_only fields are not included as they are\ngenerated/set by the backend.\n\n## Attributes\n- `name` - Variant name (required, non-empty)\n- `pipeline_graph` - Advanced graph representation (required)\n- `pipeline_graph_simple` - Simplified graph representation (required)"
      },
      "VariantReference": {
        "properties": {
          "source": {
            "type": "string",
            "const": "variant",
            "title": "Source",
            "default": "variant"
          },
          "pipeline_id": {
            "type": "string",
            "title": "Pipeline Id",
            "description": "ID of the pipeline containing the variant.",
            "examples": [
              "pipeline-a3f5d9e1"
            ]
          },
          "variant_id": {
            "type": "string",
            "title": "Variant Id",
            "description": "ID of the variant within the pipeline.",
            "examples": [
              "variant-abc123"
            ]
          }
        },
        "type": "object",
        "required": [
          "pipeline_id",
          "variant_id"
        ],
        "title": "VariantReference",
        "description": "**Reference to an existing pipeline variant by IDs.**\n\nUsed when specifying a pipeline for tests by referencing an existing\nstored variant instead of providing an inline graph.\n\n## Attributes\n- `source` - Discriminator field, always \"variant\" for this type\n- `pipeline_id` - ID of the pipeline containing the variant\n- `variant_id` - ID of the variant to use\n\n### Example\n```json\n{\n  \"source\": \"variant\",\n  \"pipeline_id\": \"pipeline-a3f5d9e1\",\n  \"variant_id\": \"variant-abc123\"\n}\n```"
      },
      "VariantUpdate": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Name",
            "description": "New variant name."
          },
          "pipeline_graph": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PipelineGraph"
              },
              {
                "type": "null"
              }
            ],
            "description": "New advanced graph (mutually exclusive with pipeline_graph_simple)."
          },
          "pipeline_graph_simple": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PipelineGraph"
              },
              {
                "type": "null"
              }
            ],
            "description": "New simplified graph (mutually exclusive with pipeline_graph)."
          }
        },
        "type": "object",
        "title": "VariantUpdate",
        "description": "**Input model for updating an existing variant.**\n\nAll fields are optional, but at least one must be provided.\nOnly one of pipeline_graph or pipeline_graph_simple can be provided per request.\nString fields (name) must be non-empty after trimming whitespace.\n\nValidation is performed in model_validator to fail fast on invalid input.\n\n## Attributes\n- `name` - Optional new variant name (non-empty after trim if provided)\n- `pipeline_graph` - Optional advanced graph (mutually exclusive with pipeline_graph_simple)\n- `pipeline_graph_simple` - Optional simplified graph (mutually exclusive with pipeline_graph)"
      },
      "Video": {
        "properties": {
          "filename": {
            "type": "string",
            "title": "Filename"
          },
          "width": {
            "type": "integer",
            "title": "Width"
          },
          "height": {
            "type": "integer",
            "title": "Height"
          },
          "fps": {
            "type": "number",
            "title": "Fps"
          },
          "frame_count": {
            "type": "integer",
            "title": "Frame Count"
          },
          "codec": {
            "type": "string",
            "title": "Codec"
          },
          "duration": {
            "type": "number",
            "title": "Duration"
          }
        },
        "type": "object",
        "required": [
          "filename",
          "width",
          "height",
          "fps",
          "frame_count",
          "codec",
          "duration"
        ],
        "title": "Video",
        "description": "**Metadata for a single input video file.**\n\n## Attributes\n- `filename` - Base name of the video file located under INPUT_VIDEO_DIR\n- `width` - Frame width in pixels\n- `height` - Frame height in pixels\n- `fps` - Frames per second for the stream\n- `frame_count` - Total number of frames in the file\n- `codec` - Normalized codec name (e.g., \"h264\" or \"h265\")\n- `duration` - Approximate duration in seconds\n\n### Example\n```json\n[\n  {\n    \"filename\": \"traffic_1080p_h264.mp4\",\n    \"width\": 1920,\n    \"height\": 1080,\n    \"fps\": 30.0,\n    \"frame_count\": 900,\n    \"codec\": \"h264\",\n    \"duration\": 30.0\n  }\n]\n```"
      },
      "VideoExistsResponse": {
        "properties": {
          "exists": {
            "type": "boolean",
            "title": "Exists",
            "description": "True if the video file exists, False otherwise."
          },
          "filename": {
            "type": "string",
            "title": "Filename",
            "description": "The filename that was checked."
          }
        },
        "type": "object",
        "required": [
          "exists",
          "filename"
        ],
        "title": "VideoExistsResponse",
        "description": "**Response indicating whether a video file exists.**\n\n## Attributes\n- `exists` - True if file exists in INPUT_VIDEO_DIR, False otherwise\n- `filename` - The filename that was checked\n\n### Example\n```json\n{\n  \"exists\": true,\n  \"filename\": \"traffic_1080p_h264.mp4\"\n}\n```"
      }
    }
  }
}