{
  "openapi": "3.1.1",
  "info": {
    "title": "Fleet Operations API",
    "description": "Unified API for managing the Cosmo Cargo fleet. Endpoints are versioned individually as capabilities evolve across warp drive generations.\n\n----\nThis schema was processed by a build processor at **4/6/2026, 11:34:32 PM**. See more in the [build configuration guide](https://zudoku.dev/docs/guides/processors).",
    "version": "/v3",
    "contact": {
      "name": "Cosmo Cargo Fleet Engineering",
      "email": "fleet@cosmocargo.dev"
    }
  },
  "tags": [
    {
      "name": "Fleet Command",
      "description": "Manage fleet vessels, assign missions, and monitor fleet-wide status. Available across all API versions."
    },
    {
      "name": "Navigation",
      "description": "Warp route calculation and hyperspace lane management. Introduced in v2 with quantum pathfinding."
    },
    {
      "name": "Cargo Bays",
      "description": "Cargo bay allocation and inventory tracking. Available in v1 and v2."
    }
  ],
  "servers": [
    {
      "url": "https://fleet.cosmocargo.dev",
      "description": "Production"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Fleet-Key"
      }
    },
    "schemas": {
      "Vessel": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "examples": [
              "ISS Horizon"
            ]
          },
          "class": {
            "type": "string",
            "enum": [
              "freighter",
              "cruiser",
              "shuttle",
              "dreadnought"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "docked",
              "in-transit",
              "maintenance",
              "decommissioned"
            ]
          }
        }
      },
      "Route": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "origin": {
            "type": "string",
            "examples": [
              "Sol-3"
            ]
          },
          "destination": {
            "type": "string",
            "examples": [
              "Proxima-b"
            ]
          },
          "distanceLightYears": {
            "type": "number",
            "examples": [
              4.24
            ]
          },
          "estimatedWarpHours": {
            "type": "number",
            "examples": [
              12.5
            ]
          }
        }
      },
      "CargoBay": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "vesselId": {
            "type": "string",
            "format": "uuid"
          },
          "capacityTons": {
            "type": "number",
            "examples": [
              5000
            ]
          },
          "usedTons": {
            "type": "number",
            "examples": [
              3200
            ]
          },
          "temperature": {
            "type": "string",
            "enum": [
              "ambient",
              "cryo",
              "plasma-shielded"
            ]
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  },
  "paths": {
    "/v3/fleet/vessels": {
      "get": {
        "tags": [
          "Fleet Command"
        ],
        "summary": "List all vessels",
        "description": "Returns fleet roster with quantum-entangled real-time positioning and predictive maintenance alerts.",
        "operationId": "listVessels_v3",
        "parameters": [
          {
            "name": "class",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "freighter",
                "cruiser",
                "shuttle",
                "dreadnought"
              ]
            }
          },
          {
            "name": "sector",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by galactic sector"
          }
        ],
        "responses": {
          "200": {
            "description": "Fleet roster with quantum positioning",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Vessel"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v3/navigation/routes": {
      "get": {
        "tags": [
          "Navigation"
        ],
        "summary": "List warp routes",
        "description": "Returns routes with real-time gravitational anomaly warnings and fuel consumption estimates.",
        "operationId": "listRoutes_v3",
        "parameters": [
          {
            "name": "maxWarpHours",
            "in": "query",
            "schema": {
              "type": "number"
            },
            "description": "Maximum acceptable travel time"
          }
        ],
        "responses": {
          "200": {
            "description": "Available routes with anomaly data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Route"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}