{
  "openapi": "3.1.0",
  "info": {
    "title": "Mana Public API",
    "description": "Mana V1 Public API",
    "version": "1.0.0"
  },
  "paths": {
    "/api/v1/api-keys": {
      "get": {
        "summary": "List Api Keys",
        "description": "List all API keys from the Mana web app context (metadata only).\n\nThis endpoint is intended for the web app's API key settings UI; API key\nauthentication is rejected with 403.",
        "operationId": "list_api_keys",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ApiKeyDTO"
                  },
                  "type": "array",
                  "title": "Response List Api Keys"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      },
      "post": {
        "summary": "Create Api Key",
        "description": "Create a new API key from the Mana web app context.\n\nReturns the raw key exactly once. The caller must store it securely —\nit cannot be retrieved again (only the hash is persisted). This endpoint is\nintended for the web app's API key settings UI; API key authentication is\nrejected with 403.",
        "operationId": "create_api_key",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApiKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateApiKeyResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    },
    "/api/v1/api-keys/{key_id}": {
      "delete": {
        "summary": "Revoke Api Key",
        "description": "Revoke an API key from the Mana web app context (soft-delete).\n\nVerifies ownership. This endpoint is intended for the web app's API key\nsettings UI; API key authentication is rejected with 403.",
        "operationId": "revoke_api_key",
        "parameters": [
          {
            "name": "key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Key Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "title": "Response Revoke Api Key"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations": {
      "post": {
        "summary": "Create Conversation",
        "description": "Create and launch a new conversation, or send a follow-up to an existing one.\n\nReturns immediately with the conversation ID and status `pending`. Track\nprogress with the stream or the status endpoint. Pass\n`parentConversationId` to add a turn to an existing conversation.\nRequests count against a limit of 60 per minute per user; above it the\nendpoint answers 429.",
        "operationId": "create_conversation",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiCreateConversationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiCreateConversationResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "409": {
            "description": "Conflict: a follow-up was sent while the conversation's turn is still running."
          },
          "429": {
            "description": "Rate limit exceeded: retry after reducing request frequency."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      },
      "get": {
        "summary": "List Conversations",
        "description": "List conversations for the authenticated user.\n\nSupports filtering by status and pagination via a cursor-backed offset.\nResults are ordered by most recently updated first.",
        "operationId": "list_conversations",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by status: pending, running, completed, canceled",
              "title": "Status"
            },
            "description": "Filter by status: pending, running, completed, canceled"
          },
          {
            "name": "pipeline_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by pipeline ID",
              "title": "Pipeline Id"
            },
            "description": "Filter by pipeline ID"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Only include conversations updated at or after this time",
              "title": "Since"
            },
            "description": "Only include conversations updated at or after this time"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "description": "Max results to return",
              "default": 50,
              "title": "Limit"
            },
            "description": "Max results to return"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Pagination cursor returned by the previous page",
              "title": "Cursor"
            },
            "description": "Pagination cursor returned by the previous page"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConversationListPage"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/conversations": {
      "get": {
        "summary": "List Public Pipeline Conversations",
        "description": "List top-level conversations in a pipeline.",
        "operationId": "list_public_pipeline_conversations",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiConversationListItem"
                  },
                  "title": "Response List Public Pipeline Conversations"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/stream": {
      "get": {
        "summary": "Stream Conversation",
        "description": "Stream a conversation's messages as Server-Sent Events (`text/event-stream`).\n\nThe stream sends a `connection` event, then replays the conversation's\nhistory, then sends `stream_phase` with `phase: \"live\"` and continues with\nlive messages. Each event name is the message type (`thinking`, `step`,\n`report`, `artifact_generated`, `conversation_status`, ...). Replayed\nhistory can include terminal `conversation_status` events (`completed`,\n`failed`, `cancelled`) of earlier turns, and a late copy of one can follow\n`stream_phase`, so confirm a terminal status with the status endpoint\nbefore treating the turn as finished. Event payloads use snake_case keys.",
        "operationId": "stream_conversation",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/respond": {
      "post": {
        "summary": "Respond To Question",
        "description": "Answer a question, save it to history, and resume a suspended run.\n\nLate answers recover the original form from history, as on WebSocket.\nPipeline-spec decisions use the spec-review route.",
        "operationId": "respond_to_question",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QuestionResponseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Respond To Question"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/spec-review": {
      "post": {
        "summary": "Review Pipeline Spec",
        "description": "Approve or comment on a presented spec through the admin-gated review service.",
        "operationId": "review_pipeline_spec",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiSpecReviewRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Review Pipeline Spec"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/cancel": {
      "post": {
        "summary": "Cancel Conversation",
        "description": "Cancel a running conversation.\n\nUses the same cancellation service as the WebSocket handler so Temporal,\nlocal, Modal, and owned Pipeline-build work share one terminal boundary.",
        "operationId": "cancel_conversation",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Cancel Conversation"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}": {
      "patch": {
        "summary": "Rename Conversation",
        "description": "Rename one of your conversations.",
        "operationId": "rename_conversation",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiUpdateConversationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConversationStatusResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      },
      "get": {
        "summary": "Get Conversation Status",
        "description": "Get current conversation status and metadata.\n\nFor polling clients that can't use SSE. Also includes any pending\nquestion the agent is waiting on.",
        "operationId": "get_conversation_status",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConversationStatusResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/archive": {
      "post": {
        "summary": "Archive Conversation",
        "description": "Archive one of your conversations, reversibly.\n\nArchiving stops what the conversation still has running, as in the app:\nits own turn, the agents it delegated to and the triggers of the Pipelines\nit owns. Chief of Staff threads cannot be archived (409).",
        "operationId": "archive_conversation",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConversationStatusResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/unarchive": {
      "post": {
        "summary": "Unarchive Conversation",
        "description": "Restore one of your archived conversations, as in the app.",
        "operationId": "unarchive_conversation",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConversationStatusResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/stop-work": {
      "post": {
        "summary": "Stop Conversation Work",
        "description": "Stop everything one of your conversations still has running, including the agents it delegated to.\n\n`POST /conversations/{conversation_id}/cancel` stops only the conversation's\nown turn; delegated agents are separate conversations and keep running.\nThis stops them too.",
        "operationId": "stop_conversation_work",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiConversationWorkStopResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/structured-output": {
      "get": {
        "summary": "Get Conversation Structured Output",
        "description": "Get structured output extracted from the run's final report.",
        "operationId": "get_conversation_structured_output",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStructuredOutputResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/sub-conversations": {
      "get": {
        "summary": "List Sub Conversations",
        "description": "List child conversations launched from a parent conversation.",
        "operationId": "list_sub_conversations",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiConversationListItem"
                  },
                  "title": "Response List Sub Conversations"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/messages": {
      "get": {
        "summary": "Get Conversation Messages",
        "description": "Fetch conversation history (protocol messages) for a conversation.\n\nReturns all protocol message types in sequence order, with an extracted\ntop-level content summary for UI display.",
        "operationId": "get_conversation_messages",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiConversationHistoryItem"
                  },
                  "title": "Response Get Conversation Messages"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/conversations/{conversation_id}/artifacts": {
      "get": {
        "summary": "Get Conversation Artifacts",
        "description": "Fetch all artifacts produced during a conversation.\n\nReturns artifact metadata (tables, charts, reports, etc.) generated\nby the agent. Internal storage details are omitted.",
        "operationId": "get_conversation_artifacts",
        "parameters": [
          {
            "name": "conversation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Conversation Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiArtifactDTO"
                  },
                  "title": "Response Get Conversation Artifacts"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines": {
      "get": {
        "summary": "List Pipelines",
        "description": "List the Pipelines the authenticated user may run, most recently updated first.\n\nThese are the Pipelines the user created and the Pipelines in Projects the\nuser owns, leaving out sub-Pipelines, which run as part of their parent:\nthe same list Mana's MCP `list_pipelines` tool gives. Read a sub-Pipeline\nwith `GET /pipelines/{pipeline_id}`.\n\nReturns a flat array. `cursor` is the integer offset of the first item;\npass the previous `cursor` plus `limit` for the next page. The response does\nnot include a pagination wrapper or nextCursor field.",
        "operationId": "list_pipelines",
        "parameters": [
          {
            "name": "archived",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Include archived pipelines instead of active ones",
              "default": false,
              "title": "Archived"
            },
            "description": "Include archived pipelines instead of active ones"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "description": "Maximum number of array items to return",
              "default": 50,
              "title": "Limit"
            },
            "description": "Maximum number of array items to return"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Integer offset used as the starting slice position",
              "title": "Cursor"
            },
            "description": "Integer offset used as the starting slice position"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiPipelineDTO"
                  },
                  "title": "Response List Pipelines"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      },
      "post": {
        "summary": "Create Public Pipeline",
        "description": "Create an empty pipeline.",
        "operationId": "create_public_pipeline",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePipelineDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "429": {
            "description": "Rate limit exceeded: retry after reducing request frequency."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/summary": {
      "get": {
        "summary": "List Public Pipelines Summary",
        "description": "Return lightweight summaries of the active Pipelines the authenticated user may run.\n\nThese are the same Pipelines as `GET /pipelines`: the Pipelines the user\ncreated and the Pipelines in Projects the user owns, leaving out\nsub-Pipelines. The list is not paginated and is ordered by last activity\n(the Pipeline, its conversations or its runs), most recent first.",
        "operationId": "list_public_pipelines_summary",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PipelineSummaryDTO"
                  },
                  "type": "array",
                  "title": "Response List Public Pipelines Summary"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}": {
      "get": {
        "summary": "Get Public Pipeline",
        "description": "Fetch a pipeline by ID.",
        "operationId": "get_public_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      },
      "patch": {
        "summary": "Update Public Pipeline",
        "description": "Rename or re-describe a pipeline.",
        "operationId": "update_public_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/UpdatePipelineDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/archive": {
      "post": {
        "summary": "Archive Public Pipeline",
        "description": "Soft-delete a pipeline.",
        "operationId": "archive_public_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/unarchive": {
      "post": {
        "summary": "Unarchive Public Pipeline",
        "description": "Restore an archived pipeline.",
        "operationId": "unarchive_public_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/triggers/pause": {
      "post": {
        "summary": "Pause Public Pipeline Triggers",
        "description": "Pause the Pipeline's automatic triggers, as Pause does in the app.\n\nPauses every live Workflow of the active revision and its sub-Pipelines'\ntriggers, without archiving the Pipeline. Repeating it changes nothing.",
        "operationId": "pause_public_pipeline_triggers",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineTriggerStateResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/triggers/resume": {
      "post": {
        "summary": "Resume Public Pipeline Triggers",
        "description": "Resume the Pipeline's paused automatic triggers, as Resume does in the app.\n\nA sub-Pipeline paused on its own stays paused. Repeating it changes nothing.",
        "operationId": "resume_public_pipeline_triggers",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineTriggerStateResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/runs": {
      "post": {
        "summary": "Run Public Pipeline",
        "description": "Run the whole Pipeline once, as Run does in the app.\n\nStarts the active revision's entry points that have work; a source with no\nnew event starts nothing, and the response lists no runs. Follow each run\nwith `GET /workflow-runs/{workflow_run_id}`. Answers 404 for a missing\nPipeline or one without an active revision, and 409 when the active\nrevision has no Workflows. To run one Workflow, use `POST /workflows/{workflow_id}/runs`.\n\nA Pipeline that starts from a file needs `file`: a Knowledge Base document id\n(an uploaded document that is ready), or the id of a file its file trigger\ndelivered. Only the file trigger runs, on that document. Answers 404 for a\nKnowledge Base document that is not yours, and 409 for a document that is not\nready or cannot be a file input, or a Pipeline with no file trigger.",
        "operationId": "run_public_pipeline",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/ApiPipelineRunRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Body"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineRunResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          },
          "429": {
            "description": "Rate limit exceeded: retry after reducing request frequency."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/runs/latest": {
      "get": {
        "summary": "Get Public Pipeline Latest Run",
        "description": "Read the Pipeline's latest completed run with its outputs, as Mana's MCP `get_pipeline_run` does.\n\nThe latest run is the newest completed top-level run that is not a\nvalidation run. Answers 404 for a Pipeline the user may not run (one they\ndid not create and that is in no Project they own) and for a Pipeline with\nno completed run yet.",
        "operationId": "get_public_pipeline_latest_run",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineRunOutputDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/runs/{workflow_run_id}": {
      "get": {
        "summary": "Get Public Pipeline Run",
        "description": "Read one run of the Pipeline with its outputs, as Mana's MCP `get_pipeline_run` does.\n\nRead again while `status` is `pending` or `running`, or while\n`summaryStatus` is `pending`. Answers 404 for a Pipeline the user may not run\nand for a run that does not belong to the Pipeline. A later stage's run id\nfrom `POST /pipelines/{pipeline_id}/runs` answers 404 until its stage starts.",
        "operationId": "get_public_pipeline_run",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "workflow_run_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiPipelineRunOutputDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/workflows": {
      "get": {
        "summary": "List Public Pipeline Workflows",
        "description": "List workflows selected by the pipeline's active revision.",
        "operationId": "list_public_pipeline_workflows",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiWorkflowSummary"
                  },
                  "title": "Response List Public Pipeline Workflows"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/workflows/{workflow_id}/modules": {
      "get": {
        "summary": "Get Public Workflow Modules",
        "description": "Return one workflow's module DAG without module source code.",
        "operationId": "get_public_workflow_modules",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiWorkflowModulesResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/workflows/{workflow_id}": {
      "get": {
        "summary": "Get Public Workflow",
        "description": "Fetch workflow metadata and entry point module IDs.",
        "operationId": "get_public_workflow",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiWorkflowDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/workflows/{workflow_id}/runs": {
      "post": {
        "summary": "Create Public Workflow Run",
        "description": "Start a manual workflow run and return immediately.",
        "operationId": "create_public_workflow_run",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/ApiWorkflowRunRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Request"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiWorkflowRunResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          },
          "409": {
            "description": "Conflict: the requested action conflicts with current resource state."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      },
      "get": {
        "summary": "List Public Workflow Runs",
        "description": "List workflow runs newest first.",
        "operationId": "list_public_workflow_runs",
        "parameters": [
          {
            "name": "workflow_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Id"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by status: pending, running, completed, failed, cancelled",
              "title": "Status"
            },
            "description": "Filter by status: pending, running, completed, failed, cancelled"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiWorkflowRunSummary"
                  },
                  "title": "Response List Public Workflow Runs"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/workflow-runs/{workflow_run_id}/artifacts": {
      "get": {
        "summary": "Get Public Workflow Run Artifacts",
        "description": "List artifacts produced during a workflow run.",
        "operationId": "get_public_workflow_run_artifacts",
        "parameters": [
          {
            "name": "workflow_run_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Run Id"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiArtifactDTO"
                  },
                  "title": "Response Get Public Workflow Run Artifacts"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/workflow-runs/{workflow_run_id}/live-artifacts": {
      "get": {
        "summary": "Get Public Workflow Run Live Artifacts",
        "description": "List LiveArtifacts appended to during a workflow run.",
        "operationId": "get_public_workflow_run_live_artifacts",
        "parameters": [
          {
            "name": "workflow_run_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiLiveArtifactDTO"
                  },
                  "title": "Response Get Public Workflow Run Live Artifacts"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/workflow-runs/{workflow_run_id}": {
      "get": {
        "summary": "Get Public Workflow Run",
        "description": "Fetch workflow run metadata.",
        "operationId": "get_public_workflow_run",
        "parameters": [
          {
            "name": "workflow_run_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Workflow Run Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiWorkflowRunDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/modules/{module_id}": {
      "get": {
        "summary": "Get Public Module",
        "description": "Fetch public module metadata without source code.",
        "operationId": "get_public_module",
        "parameters": [
          {
            "name": "module_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Module Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiModuleDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/artifacts": {
      "get": {
        "summary": "List Public Pipeline Artifacts",
        "description": "List artifacts in a pipeline.",
        "operationId": "list_public_pipeline_artifacts",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiPipelineArtifactSummary"
                  },
                  "title": "Response List Public Pipeline Artifacts"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/artifacts/upload": {
      "post": {
        "summary": "Upload Artifact",
        "description": "Upload a file as an artifact in a single multipart request.",
        "operationId": "upload_artifact",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_artifact"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiUploadArtifactResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "413": {
            "description": "Payload too large: uploaded artifact exceeds the maximum supported size."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/artifacts/{artifact_id}/download": {
      "get": {
        "summary": "Download Artifact",
        "description": "Authorize the reader and stream the artifact's original bytes as an attachment.",
        "operationId": "download_artifact",
        "parameters": [
          {
            "name": "artifact_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Artifact Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Artifact file bytes with the stored content type and an attachment filename.",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "206": {
            "description": "The requested single byte range, with Content-Range and Accept-Ranges headers.",
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "416": {
            "description": "The byte range is unsatisfiable. Content-Range reports the full file size."
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/live-artifacts": {
      "get": {
        "summary": "List Public Pipeline Live Artifacts",
        "description": "List live artifacts in a pipeline.",
        "operationId": "list_public_pipeline_live_artifacts",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          },
          {
            "name": "pipeline_revision_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline revision scope",
              "title": "Pipeline Revision Id"
            },
            "description": "Optional pipeline revision scope"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiLiveArtifactDTO"
                  },
                  "title": "Response List Public Pipeline Live Artifacts"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/pipelines/{pipeline_id}/dashboards": {
      "get": {
        "summary": "List Public Pipeline Dashboards",
        "description": "List latest dashboards for a pipeline.",
        "operationId": "list_public_pipeline_dashboards",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Pipeline Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiDashboardSummaryDTO"
                  },
                  "title": "Response List Public Pipeline Dashboards"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/live-artifacts": {
      "get": {
        "summary": "List Public Live Artifacts",
        "description": "List live artifacts for the authenticated user.",
        "operationId": "list_public_live_artifacts",
        "parameters": [
          {
            "name": "pipeline_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline filter",
              "title": "Pipeline Id"
            },
            "description": "Optional pipeline filter"
          },
          {
            "name": "pipeline_revision_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline revision scope",
              "title": "Pipeline Revision Id"
            },
            "description": "Optional pipeline revision scope"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiLiveArtifactDTO"
                  },
                  "title": "Response List Public Live Artifacts"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/live-artifacts/{live_artifact_id}": {
      "get": {
        "summary": "Get Public Live Artifact",
        "description": "Fetch a live artifact by ID.",
        "operationId": "get_public_live_artifact",
        "parameters": [
          {
            "name": "live_artifact_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Live Artifact Id"
            }
          },
          {
            "name": "pipeline_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline scope",
              "title": "Pipeline Id"
            },
            "description": "Optional pipeline scope"
          },
          {
            "name": "pipeline_revision_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline revision scope",
              "title": "Pipeline Revision Id"
            },
            "description": "Optional pipeline revision scope"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiLiveArtifactDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/live-artifacts/{live_artifact_id}/data": {
      "get": {
        "summary": "Get Public Live Artifact Data",
        "description": "Fetch paginated rows from a live artifact.",
        "operationId": "get_public_live_artifact_data",
        "parameters": [
          {
            "name": "live_artifact_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Live Artifact Id"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 10000,
              "minimum": 1,
              "default": 1000,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 1000000,
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "pipeline_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline scope",
              "title": "Pipeline Id"
            },
            "description": "Optional pipeline scope"
          },
          {
            "name": "pipeline_revision_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline revision scope",
              "title": "Pipeline Revision Id"
            },
            "description": "Optional pipeline revision scope"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiveArtifactDataDTO"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/live-artifacts/{live_artifact_id}/stream": {
      "get": {
        "summary": "Stream Live Artifact",
        "description": "Stream change notifications for a live artifact as Server-Sent Events.\n\nEach `live_artifact` event carries the table's metadata, including\n`updated_at` and `row_count`, not its rows; read rows from the `/data`\nendpoint. `heartbeat` events keep the connection open.",
        "operationId": "stream_live_artifact",
        "parameters": [
          {
            "name": "live_artifact_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Live Artifact Id"
            }
          },
          {
            "name": "pipeline_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline scope",
              "title": "Pipeline Id"
            },
            "description": "Optional pipeline scope"
          },
          {
            "name": "pipeline_revision_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional pipeline revision scope",
              "title": "Pipeline Revision Id"
            },
            "description": "Optional pipeline revision scope"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          },
          "404": {
            "description": "Not found: the resource does not exist or is not visible to the authenticated principal."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/projects": {
      "get": {
        "summary": "List Public Projects",
        "description": "List your Projects, as the app's Projects page does.\n\nPass a Project's `id` as `projectId` when you create a conversation to file it there.",
        "operationId": "list_public_projects",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "active",
                "archived",
                "all"
              ],
              "type": "string",
              "description": "Which Projects to list",
              "default": "active",
              "title": "Status"
            },
            "description": "Which Projects to list"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApiProjectDTO"
                  },
                  "title": "Response List Public Projects"
                }
              }
            }
          },
          "422": {
            "description": "Validation error: request parameters or body failed schema validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/models": {
      "get": {
        "summary": "List Public Models",
        "description": "List the models you can pass as `model` when you create a conversation, as the app's model picker does.\n\nEach model lists the `reasoning` values creation accepts with it. When your\naccount is in a program with a set model, every conversation runs on that\nmodel whatever `model` says: `programModelId` names it and it is the only\nmodel listed. Omit `model` to use the agent's own default. Answers 503 when\nthe model catalog cannot be read.",
        "operationId": "list_public_models",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiModelsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request: invalid cursor, unsupported value, or malformed request state."
          },
          "401": {
            "description": "Unauthorized: missing, invalid, or expired authentication credentials."
          },
          "403": {
            "description": "Forbidden: credentials are valid but cannot access this resource or auth mode is not allowed."
          },
          "500": {
            "description": "Internal server error: an unexpected server-side failure occurred."
          }
        },
        "security": [
          {
            "apiKeyAuth": []
          }
        ]
      }
    },
    "/api/v1/health": {
      "get": {
        "tags": [
          "health"
        ],
        "summary": "Health Check",
        "description": "Report that the API is up. Call it without authentication.",
        "operationId": "health_check",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Health Check"
                }
              }
            }
          }
        },
        "security": []
      }
    }
  },
  "components": {
    "schemas": {
      "ApiArtifactDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "type": {
            "$ref": "#/components/schemas/ArtifactType"
          },
          "category": {
            "$ref": "#/components/schemas/ArtifactCategory"
          },
          "status": {
            "$ref": "#/components/schemas/ArtifactStatus"
          },
          "mimeType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mimetype"
          },
          "filePath": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Filepath"
          },
          "sizeBytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sizebytes"
          },
          "sourceType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ArtifactSourceType"
              },
              {
                "type": "null"
              }
            ]
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "conversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationid"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "conversationUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationurl"
          },
          "downloadUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Downloadurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "title",
          "type",
          "category",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiArtifactDTO",
        "description": "Artifact metadata for public API responses."
      },
      "ApiConversationHistoryItem": {
        "properties": {
          "sequence": {
            "type": "integer",
            "title": "Sequence"
          },
          "messageType": {
            "type": "string",
            "title": "Messagetype"
          },
          "content": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content"
          },
          "messageData": {
            "additionalProperties": true,
            "type": "object",
            "title": "Messagedata"
          },
          "createdAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Createdat"
          },
          "conversationUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationurl"
          }
        },
        "type": "object",
        "required": [
          "sequence",
          "messageType",
          "messageData"
        ],
        "title": "ApiConversationHistoryItem",
        "description": "Public protocol message summary with API URL fields."
      },
      "ApiConversationListItem": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "createdAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Createdat"
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updatedat"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "parentConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parentconversationid"
          },
          "conversationUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationurl"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          }
        },
        "type": "object",
        "required": [
          "id"
        ],
        "title": "ApiConversationListItem",
        "description": "Public conversation list item with API URL fields."
      },
      "ApiConversationListPage": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ApiConversationListItem"
            },
            "type": "array",
            "title": "Items"
          },
          "nextCursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Nextcursor"
          }
        },
        "type": "object",
        "title": "ApiConversationListPage",
        "description": "Paginated public conversation list response."
      },
      "ApiConversationStatusResponse": {
        "properties": {
          "conversationId": {
            "type": "string",
            "title": "Conversationid"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "pendingQuestion": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pendingquestion"
          },
          "createdAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Createdat"
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updatedat"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "parentConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parentconversationid"
          },
          "conversationUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationurl"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "streamUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Streamurl"
          }
        },
        "type": "object",
        "required": [
          "conversationId",
          "status"
        ],
        "title": "ApiConversationStatusResponse",
        "description": "Public conversation status for polling clients."
      },
      "ApiConversationWorkStopResponse": {
        "properties": {
          "stoppedConversationIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Stoppedconversationids",
            "description": "The conversation and every agent it delegated to that was still running"
          }
        },
        "type": "object",
        "required": [
          "stoppedConversationIds"
        ],
        "title": "ApiConversationWorkStopResponse",
        "description": "Conversations that a public stop-work request marked stopped, children first."
      },
      "ApiCreateConversationRequest": {
        "properties": {
          "prompt": {
            "type": "string",
            "title": "Prompt",
            "description": "The user's prompt to start the conversation"
          },
          "agentType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Agenttype",
            "description": "Agent type for the run. Public JSON request bodies use the camelCase alias `agentType`. Supported public values are `jethro` (the default), `exploratory` and `pipeline-builder`. Jethro answers or hands the work to a specialist, such as Pipeline Builder for a Pipeline, as the Mana app does; it takes no `model`, `reasoning` or `responseSchema`. A deployment that does not run Jethro uses `exploratory` as the default and refuses `jethro` with 422. A follow-up that omits it keeps the conversation's agent.",
            "example": "jethro"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title",
            "description": "Optional conversation title"
          },
          "artifactIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Artifactids",
            "description": "Optional artifact IDs to attach"
          },
          "responseSchema": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Responseschema",
            "description": "Optional JSON Schema used to extract structured output from the final report. Exploratory only: a new conversation must name `agentType` `exploratory`, because the default, Jethro, refuses it with 422. A follow-up that sends it runs as Exploratory."
          },
          "parentConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parentconversationid",
            "description": "ID of an existing conversation to continue. Public JSON request bodies use the camelCase alias `parentConversationId`; follow-up requests append to and return the same conversation."
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid",
            "description": "Optional pipeline ID to scope the conversation to"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid",
            "description": "Optional project ID to scope the conversation to"
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Model",
            "description": "Optional model to use for the conversation"
          },
          "reasoning": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "none",
                  "low",
                  "medium",
                  "high",
                  "xhigh",
                  "max"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Reasoning",
            "description": "Optional reasoning effort level"
          }
        },
        "type": "object",
        "required": [
          "prompt"
        ],
        "title": "ApiCreateConversationRequest",
        "description": "Public request to create and launch a new conversation."
      },
      "ApiCreateConversationResponse": {
        "properties": {
          "conversationId": {
            "type": "string",
            "title": "Conversationid"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "description": "Always `pending`: the run has been accepted, not started",
            "default": "pending"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "projectId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Projectid"
          },
          "conversationUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationurl"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "streamUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Streamurl"
          }
        },
        "type": "object",
        "required": [
          "conversationId"
        ],
        "title": "ApiCreateConversationResponse",
        "description": "Public response after launching a new conversation."
      },
      "ApiDashboardSummaryDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "lineageId": {
            "type": "string",
            "title": "Lineageid"
          },
          "version": {
            "type": "integer",
            "title": "Version"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "status": {
            "$ref": "#/components/schemas/DashboardStatus"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          },
          "previewCellId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previewcellid"
          },
          "previewVersion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previewversion"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "dashboardUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dashboardurl"
          }
        },
        "type": "object",
        "required": [
          "id",
          "pipelineId",
          "lineageId",
          "version",
          "name",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiDashboardSummaryDTO",
        "description": "Public dashboard summary with UI URLs."
      },
      "ApiKeyDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "keyPrefix": {
            "type": "string",
            "title": "Keyprefix"
          },
          "scopes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Scopes"
          },
          "isActive": {
            "type": "boolean",
            "title": "Isactive"
          },
          "lastUsedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastusedat"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "expiresAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expiresat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "keyPrefix",
          "isActive",
          "createdAt"
        ],
        "title": "ApiKeyDTO",
        "description": "API key metadata (excludes the raw key, which is never stored)."
      },
      "ApiLiveArtifactDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "schemaDefinition": {
            "additionalProperties": true,
            "type": "object",
            "title": "Schemadefinition"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "streamUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Streamurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "type",
          "schemaDefinition",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiLiveArtifactDTO",
        "description": "LiveArtifact metadata exposed through the public API."
      },
      "ApiModelDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "The value to pass as `model` when you create a conversation"
          },
          "label": {
            "type": "string",
            "title": "Label"
          },
          "reasoningLevels": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Reasoninglevels",
            "description": "Values the model accepts as `reasoning`"
          }
        },
        "type": "object",
        "required": [
          "id",
          "label",
          "reasoningLevels"
        ],
        "title": "ApiModelDTO",
        "description": "A model a conversation may run on."
      },
      "ApiModelsResponse": {
        "properties": {
          "models": {
            "items": {
              "$ref": "#/components/schemas/ApiModelDTO"
            },
            "type": "array",
            "title": "Models"
          },
          "programModelId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Programmodelid",
            "description": "When set, the caller's program runs every conversation on this model, whatever `model` says, and `models` lists only it"
          }
        },
        "type": "object",
        "required": [
          "models"
        ],
        "title": "ApiModelsResponse",
        "description": "The models available to the caller."
      },
      "ApiModuleDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "purpose": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Purpose"
          },
          "moduleType": {
            "type": "string",
            "title": "Moduletype"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "expectedOutputType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expectedoutputtype"
          },
          "parameters": {
            "additionalProperties": true,
            "type": "object",
            "title": "Parameters"
          },
          "defaultTriggerConfig": {
            "additionalProperties": true,
            "type": "object",
            "title": "Defaulttriggerconfig"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "workflowId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workflowid"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "workflowUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workflowurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "moduleType",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiModuleDTO",
        "description": "Public module description without executable code or internal fields."
      },
      "ApiModuleNode": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "moduleType": {
            "type": "string",
            "title": "Moduletype"
          },
          "status": {
            "type": "string",
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "moduleType",
          "status"
        ],
        "title": "ApiModuleNode",
        "description": "Public module node for workflow DAG rendering."
      },
      "ApiPipelineArtifactSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "reportPresentation": {
            "$ref": "#/components/schemas/ReportPresentation"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "isInbox": {
            "type": "boolean",
            "title": "Isinbox",
            "default": false
          },
          "inboxHeld": {
            "type": "boolean",
            "title": "Inboxheld",
            "default": false
          },
          "isRead": {
            "type": "boolean",
            "title": "Isread",
            "default": false
          },
          "moduleRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Modulerunid"
          },
          "workflowName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workflowname"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "pipelineName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelinename"
          },
          "canOpenPipeline": {
            "type": "boolean",
            "title": "Canopenpipeline",
            "default": false
          },
          "tickerPages": {
            "items": {
              "$ref": "#/components/schemas/PipelineTickerPageDTO"
            },
            "type": "array",
            "title": "Tickerpages"
          },
          "reportKind": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reportkind"
          },
          "sourceKind": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "pipeline",
                  "task"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcekind"
          },
          "sourceConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceconversationid"
          },
          "sourceTitle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcetitle"
          },
          "mimeType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mimetype"
          },
          "fileExtension": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fileextension"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "downloadUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Downloadurl"
          }
        },
        "type": "object",
        "required": [
          "id",
          "title",
          "type",
          "createdAt"
        ],
        "title": "ApiPipelineArtifactSummary",
        "description": "Public artifact summary with download URL."
      },
      "ApiPipelineDTO": {
        "properties": {
          "itemStatus": {
            "$ref": "#/components/schemas/WorkItemStatusDTO"
          },
          "ownerItemStatus": {
            "$ref": "#/components/schemas/WorkItemStatusDTO"
          },
          "latestTriggerCheck": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PipelineTriggerCheckDTO"
              },
              {
                "type": "null"
              }
            ]
          },
          "tickerPages": {
            "items": {
              "$ref": "#/components/schemas/PipelineTickerPageDTO"
            },
            "type": "array",
            "title": "Tickerpages"
          },
          "hasOpenBuild": {
            "type": "boolean",
            "title": "Hasopenbuild",
            "description": "True when the Pipeline has a nonterminal Builder build.",
            "default": false
          },
          "id": {
            "type": "string",
            "title": "Id"
          },
          "orgId": {
            "type": "string",
            "title": "Orgid"
          },
          "createdByUserId": {
            "type": "string",
            "title": "Createdbyuserid"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags",
            "description": "Arbitrary string tags for categorization"
          },
          "status": {
            "$ref": "#/components/schemas/PipelineStatus"
          },
          "ownerConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ownerconversationid"
          },
          "triggerSchedules": {
            "items": {
              "$ref": "#/components/schemas/PipelineTriggerScheduleDTO"
            },
            "type": "array",
            "title": "Triggerschedules",
            "description": "Active-revision and paused trigger schedules. Next occurrences are calendar opportunities, not execution guarantees; conditional triggers check their condition at that time."
          },
          "componentPipelineIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Componentpipelineids",
            "description": "Component pipeline IDs recorded in pipeline metadata"
          },
          "sourcePipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcepipelineid"
          },
          "parentPipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parentpipelineid"
          },
          "isSubscribed": {
            "type": "boolean",
            "title": "Issubscribed",
            "default": false
          },
          "lastPushedRevisionId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastpushedrevisionid"
          },
          "lastPushedSourceRevisionId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastpushedsourcerevisionid"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          },
          "workflowCount": {
            "type": "integer",
            "title": "Workflowcount",
            "description": "Number of workflows in the pipeline (org-scoped).",
            "default": 0
          },
          "artifactCount": {
            "type": "integer",
            "title": "Artifactcount",
            "description": "Artifacts with this pipeline_id (org-scoped).",
            "default": 0
          },
          "runCount": {
            "type": "integer",
            "title": "Runcount",
            "description": "Workflow runs under workflows in this pipeline (org-scoped).",
            "default": 0
          },
          "lastRanAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastranat",
            "description": "Most recent workflow-run start time across this pipeline's workflows."
          },
          "lastRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastrunid",
            "description": "ID of the pipeline's most recent workflow run, or None if it never ran."
          },
          "lastRunStatus": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastrunstatus",
            "description": "Status of the pipeline's most recent workflow run, or None if it never ran."
          },
          "isLive": {
            "type": "boolean",
            "title": "Islive",
            "description": "True when the pipeline has any automatic trigger.",
            "default": false
          },
          "triggerKinds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Triggerkinds",
            "description": "Distinct non-manual trigger kinds driving this pipeline (e.g. ['time', 'data'])."
          },
          "triggerSummary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Triggersummary",
            "description": "Short human-readable cadence label for the pipeline's automatic triggers (e.g. 'Scheduled at 09:30', 'Every 30 min, and Web monitor (hourly)'). None when not live."
          },
          "triggersPaused": {
            "type": "boolean",
            "title": "Triggerspaused",
            "description": "True when the pipeline has automatic triggers that are configured but paused (their workflow is paused, or the trigger itself is paused, so they don't fire). Mutually exclusive with is_live; lets the UI show a distinct 'Paused' state instead of the pipeline silently dropping out of 'Live'.",
            "default": false
          },
          "pausedBy": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "user",
                  "staff",
                  "agent",
                  "system",
                  "unknown"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Pausedby",
            "description": "Recorded pause actor kind while triggers_paused; unknown for legacy or mixed actors."
          },
          "pausedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pausedat",
            "description": "When this pipeline pause was recorded, while triggers_paused. None for a pause with no user record (repair, first build, failure circuit)."
          },
          "automaticFailureCircuits": {
            "items": {
              "$ref": "#/components/schemas/AutomaticTriggerFailureCircuitDTO"
            },
            "type": "array",
            "title": "Automaticfailurecircuits",
            "description": "Unresolved automatic-trigger systematic failure circuits for this pipeline."
          },
          "automaticRepairAttempts": {
            "items": {
              "$ref": "#/components/schemas/SystematicCodeRepairAttemptDTO"
            },
            "type": "array",
            "title": "Automaticrepairattempts",
            "description": "Typed automatic-repair lifecycle records for this Pipeline's contained failures."
          },
          "hasAgent": {
            "type": "boolean",
            "title": "Hasagent",
            "description": "True when the pipeline has at least one active/paused analyst (agent) module. Only populated by the list endpoint; defaults to False on single-pipeline fetches.",
            "default": false
          },
          "projectIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Projectids",
            "description": "Project memberships (many-to-many) for list surfaces."
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          }
        },
        "type": "object",
        "required": [
          "id",
          "orgId",
          "createdByUserId",
          "name",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiPipelineDTO",
        "description": "Public pipeline representation with UI URL."
      },
      "ApiPipelineModuleEdge": {
        "properties": {
          "sourceModuleId": {
            "type": "string",
            "title": "Sourcemoduleid"
          },
          "targetModuleId": {
            "type": "string",
            "title": "Targetmoduleid"
          },
          "kind": {
            "type": "string",
            "title": "Kind",
            "default": "dependency"
          },
          "passResults": {
            "type": "boolean",
            "title": "Passresults",
            "default": true
          }
        },
        "type": "object",
        "required": [
          "sourceModuleId",
          "targetModuleId"
        ],
        "title": "ApiPipelineModuleEdge",
        "description": "Public pipeline graph edge."
      },
      "ApiPipelineRunOutputDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "workflowId": {
            "type": "string",
            "title": "Workflowid"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "cancelled"
            ],
            "title": "Status"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          },
          "checkSummary": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowRunCheckSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "runUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Runurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          },
          "summaryStatus": {
            "type": "string",
            "enum": [
              "ready",
              "pending",
              "unavailable"
            ],
            "title": "Summarystatus",
            "description": "`ready`: the summary is final. `pending`: read again later for the summary, even when the status is final. `unavailable`: this run has no summary; use its artifacts."
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl",
            "description": "Link to the Pipeline in the Mana app."
          },
          "runPageUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Runpageurl",
            "description": "Link to this run in the Mana app."
          },
          "artifacts": {
            "items": {
              "$ref": "#/components/schemas/ApiArtifactDTO"
            },
            "type": "array",
            "title": "Artifacts",
            "description": "At most 20 of the run's artifacts. List all of them with `GET /workflow-runs/{id}/artifacts`."
          },
          "dashboards": {
            "items": {
              "$ref": "#/components/schemas/ApiDashboardSummaryDTO"
            },
            "type": "array",
            "title": "Dashboards",
            "description": "The Pipeline's dashboards, each at its latest version."
          }
        },
        "type": "object",
        "required": [
          "id",
          "workflowId",
          "pipelineId",
          "status",
          "createdAt",
          "updatedAt",
          "summaryStatus"
        ],
        "title": "ApiPipelineRunOutputDTO",
        "description": "One run of a Pipeline with its outputs: the summary, the run's artifacts and the Pipeline's dashboards."
      },
      "ApiPipelineRunRequest": {
        "properties": {
          "file": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PipelineFileInput"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a Pipeline that starts from a file: the document to run it on. Only its file trigger runs. Omit for any other Pipeline."
          }
        },
        "type": "object",
        "title": "ApiPipelineRunRequest",
        "description": "Optional input for running a whole Pipeline once."
      },
      "ApiPipelineRunResponse": {
        "properties": {
          "workflowRunIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Workflowrunids",
            "description": "Started Workflow runs; follow each with GET /workflow-runs/{id}"
          },
          "startedWorkflowIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Startedworkflowids"
          },
          "runUrls": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Runurls",
            "description": "The API URL of each started run, in workflowRunIds order"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "workflowRunIds",
          "startedWorkflowIds",
          "runUrls",
          "message"
        ],
        "title": "ApiPipelineRunResponse",
        "description": "Public result of running a whole Pipeline once."
      },
      "ApiPipelineTriggerStateResponse": {
        "properties": {
          "triggersPaused": {
            "type": "boolean",
            "title": "Triggerspaused",
            "description": "Whether the Pipeline's automatic triggers are now paused"
          },
          "updatedWorkflowIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Updatedworkflowids",
            "description": "Workflows whose triggers this request changed"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "triggersPaused",
          "updatedWorkflowIds",
          "message"
        ],
        "title": "ApiPipelineTriggerStateResponse",
        "description": "Public result of pausing or resuming a Pipeline's automatic triggers."
      },
      "ApiProjectDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "description": "`active` or `archived`"
          },
          "pipelineCount": {
            "type": "integer",
            "title": "Pipelinecount"
          },
          "conversationCount": {
            "type": "integer",
            "title": "Conversationcount"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "status",
          "pipelineCount",
          "conversationCount",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiProjectDTO",
        "description": "A Project of the caller's, for filing conversations with `projectId`."
      },
      "ApiSpecReviewRequest": {
        "properties": {
          "formId": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "title": "Formid"
          },
          "decision": {
            "type": "string",
            "enum": [
              "accept",
              "feedback"
            ],
            "title": "Decision"
          },
          "feedback": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 10000
              },
              {
                "type": "null"
              }
            ],
            "title": "Feedback"
          }
        },
        "type": "object",
        "required": [
          "formId",
          "decision"
        ],
        "title": "ApiSpecReviewRequest",
        "description": "Approve a presented Pipeline spec or request changes in words."
      },
      "ApiUpdateConversationRequest": {
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Title",
            "description": "The conversation's new title"
          }
        },
        "type": "object",
        "required": [
          "title"
        ],
        "title": "ApiUpdateConversationRequest",
        "description": "Public request to rename a conversation."
      },
      "ApiUploadArtifactResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "mimeType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mimetype"
          },
          "sizeBytes": {
            "type": "integer",
            "title": "Sizebytes"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "pipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineid"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "downloadUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Downloadurl"
          }
        },
        "type": "object",
        "required": [
          "id",
          "title",
          "sizeBytes",
          "createdAt"
        ],
        "title": "ApiUploadArtifactResponse",
        "description": "Public response after uploading a file as an artifact."
      },
      "ApiWorkflowDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "workflowUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workflowurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          },
          "entryPointModuleIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Entrypointmoduleids"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "status",
          "pipelineId",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiWorkflowDTO",
        "description": "Public workflow detail."
      },
      "ApiWorkflowModulesResponse": {
        "properties": {
          "workflowId": {
            "type": "string",
            "title": "Workflowid"
          },
          "modules": {
            "items": {
              "$ref": "#/components/schemas/ApiModuleNode"
            },
            "type": "array",
            "title": "Modules"
          },
          "edges": {
            "items": {
              "$ref": "#/components/schemas/ApiPipelineModuleEdge"
            },
            "type": "array",
            "title": "Edges"
          }
        },
        "type": "object",
        "required": [
          "workflowId"
        ],
        "title": "ApiWorkflowModulesResponse",
        "description": "Workflow modules plus graph edges."
      },
      "ApiWorkflowRunDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "workflowId": {
            "type": "string",
            "title": "Workflowid"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "cancelled"
            ],
            "title": "Status"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          },
          "checkSummary": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowRunCheckSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "runUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Runurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "workflowId",
          "pipelineId",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiWorkflowRunDTO",
        "description": "Public workflow run detail."
      },
      "ApiWorkflowRunRequest": {
        "properties": {
          "entryPoint": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Entrypoint",
            "description": "Logical ID of the workflow trigger to start from. Omit to retain the default run behavior."
          }
        },
        "type": "object",
        "title": "ApiWorkflowRunRequest",
        "description": "Optional selection for a manual workflow run."
      },
      "ApiWorkflowRunResponse": {
        "properties": {
          "workflowRunId": {
            "type": "string",
            "title": "Workflowrunid"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "cancelled"
            ],
            "title": "Status"
          },
          "runUrl": {
            "type": "string",
            "title": "Runurl"
          },
          "streamUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Streamurl"
          }
        },
        "type": "object",
        "required": [
          "workflowRunId",
          "status",
          "runUrl"
        ],
        "title": "ApiWorkflowRunResponse",
        "description": "Response returned after a manual workflow run is started."
      },
      "ApiWorkflowRunSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "workflowId": {
            "type": "string",
            "title": "Workflowid"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "completed",
              "failed",
              "cancelled"
            ],
            "title": "Status"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          },
          "checkSummary": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkflowRunCheckSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "runUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Runurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "workflowId",
          "pipelineId",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiWorkflowRunSummary",
        "description": "Public workflow run summary."
      },
      "ApiWorkflowSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "pipelineUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipelineurl"
          },
          "workflowUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workflowurl"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updatedat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "status",
          "pipelineId",
          "createdAt",
          "updatedAt"
        ],
        "title": "ApiWorkflowSummary",
        "description": "Public latest-version workflow summary."
      },
      "AppliedDefinition": {
        "properties": {
          "classMatch": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SectorPhraseMatch"
              },
              {
                "type": "null"
              }
            ]
          },
          "rank": {
            "$ref": "#/components/schemas/RankDefinition"
          },
          "listing": {
            "$ref": "#/components/schemas/ListingFilters"
          },
          "security": {
            "$ref": "#/components/schemas/SecuritySelection"
          },
          "shareClass": {
            "$ref": "#/components/schemas/ShareClassHandling"
          },
          "asOf": {
            "$ref": "#/components/schemas/AsOf"
          }
        },
        "type": "object",
        "required": [
          "classMatch",
          "rank",
          "listing",
          "security",
          "shareClass",
          "asOf"
        ],
        "title": "AppliedDefinition",
        "description": "Everything that decided membership, as the helper applied it.\n\nAttributes:\n    class_match: How the sector phrase resolved; None without a phrase.\n    rank: The ordering and the cut.\n    listing: Venue, domicile and market-cap filters.\n    security: The security types kept.\n    share_class: How an issuer's lines were merged.\n    as_of: The data dates. Not part of `definition_hash`."
      },
      "ArtifactCategory": {
        "type": "string",
        "enum": [
          "terminal",
          "intermediate",
          "report"
        ],
        "title": "ArtifactCategory"
      },
      "ArtifactSourceType": {
        "type": "string",
        "enum": [
          "user_upload",
          "agent",
          "module",
          "system"
        ],
        "title": "ArtifactSourceType"
      },
      "ArtifactStatus": {
        "type": "string",
        "enum": [
          "pending",
          "generated",
          "validated",
          "error"
        ],
        "title": "ArtifactStatus"
      },
      "ArtifactType": {
        "type": "string",
        "enum": [
          "structured_data",
          "text",
          "json",
          "csv",
          "report",
          "chart",
          "table",
          "list",
          "data",
          "link",
          "document",
          "image",
          "code",
          "signal",
          "other"
        ],
        "title": "ArtifactType"
      },
      "AsOf": {
        "properties": {
          "runDate": {
            "type": "string",
            "format": "date",
            "title": "Rundate"
          },
          "marketCapDateFirst": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Marketcapdatefirst"
          },
          "marketCapDateLast": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Marketcapdatelast"
          },
          "pointInTime": {
            "type": "boolean",
            "const": false,
            "title": "Pointintime",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "runDate",
          "marketCapDateFirst",
          "marketCapDateLast"
        ],
        "title": "AsOf",
        "description": "When the data behind the universe is from.\n\nAttributes:\n    run_date: The date the query ran (UTC).\n    market_cap_date_first: The oldest market-cap date among the members.\n    market_cap_date_last: The newest market-cap date among the members.\n    point_in_time: Always False: the query reads the latest fundamentals and FX\n        with no date bound, so a backdated run still uses today's market caps."
      },
      "AutomaticTriggerCircuitResolutionReason": {
        "type": "string",
        "enum": [
          "connection_reconnected",
          "fingerprint_changed",
          "successful_module_run",
          "owner_resumed",
          "canary_succeeded"
        ],
        "title": "AutomaticTriggerCircuitResolutionReason",
        "description": "Typed reasons a failure sequence or open circuit stopped applying."
      },
      "AutomaticTriggerFailureCircuitDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "pipelineId": {
            "type": "string",
            "title": "Pipelineid"
          },
          "pipelineRevisionId": {
            "type": "string",
            "title": "Pipelinerevisionid"
          },
          "moduleId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Moduleid"
          },
          "fingerprint": {
            "type": "string",
            "title": "Fingerprint"
          },
          "failureClass": {
            "type": "string",
            "title": "Failureclass"
          },
          "consecutiveCount": {
            "type": "integer",
            "title": "Consecutivecount"
          },
          "firstSeenAt": {
            "type": "string",
            "format": "date-time",
            "title": "Firstseenat"
          },
          "lastSeenAt": {
            "type": "string",
            "format": "date-time",
            "title": "Lastseenat"
          },
          "trippedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Trippedat"
          },
          "resolvedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolvedat"
          },
          "resolutionReason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AutomaticTriggerCircuitResolutionReason"
              },
              {
                "type": "null"
              }
            ]
          },
          "representativeWorkflowRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Representativeworkflowrunid"
          },
          "representativeModuleRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Representativemodulerunid"
          },
          "state": {
            "$ref": "#/components/schemas/AutomaticTriggerFailureCircuitState"
          }
        },
        "type": "object",
        "required": [
          "id",
          "pipelineId",
          "pipelineRevisionId",
          "fingerprint",
          "failureClass",
          "consecutiveCount",
          "firstSeenAt",
          "lastSeenAt",
          "state"
        ],
        "title": "AutomaticTriggerFailureCircuitDTO",
        "description": "Privacy-safe circuit state exposed to an organization owner."
      },
      "AutomaticTriggerFailureCircuitState": {
        "type": "string",
        "enum": [
          "armed",
          "open",
          "resolved"
        ],
        "title": "AutomaticTriggerFailureCircuitState",
        "description": "Lifecycle of one automatic-trigger failure fingerprint sequence."
      },
      "Body_upload_artifact": {
        "properties": {
          "file": {
            "type": "string",
            "contentMediaType": "application/octet-stream",
            "title": "File"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "pipeline_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pipeline Id"
          }
        },
        "type": "object",
        "required": [
          "file"
        ],
        "title": "Body_upload_artifact"
      },
      "CheckedSource": {
        "type": "string",
        "enum": [
          "sec_filings",
          "news",
          "press_releases",
          "earnings_transcripts",
          "web_news",
          "documents",
          "edgar_filings",
          "edgar_filing_documents",
          "web_pages",
          "insider_trades",
          "institutional_holdings_13f",
          "podcasts",
          "x_posts",
          "warehouse",
          "fda",
          "clinical_trials",
          "direct_http"
        ],
        "title": "CheckedSource",
        "description": "A data source whose reads are recorded on a WorkflowRun.\n\nDocuments-corpus sources use the corpus's own ``source_type`` values so a\n``get_documents`` row is attributed to the feed it came from."
      },
      "ConversationStructuredOutputResponse": {
        "properties": {
          "structuredOutput": {
            "title": "Structuredoutput"
          },
          "structuredOutputError": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Structuredoutputerror"
          }
        },
        "type": "object",
        "required": [
          "structuredOutput"
        ],
        "title": "ConversationStructuredOutputResponse",
        "description": "Structured output extracted from a conversation's final report."
      },
      "CreateApiKeyRequest": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name",
            "description": "Human-readable label for this key (e.g. 'Clay Integration')"
          }
        },
        "type": "object",
        "required": [
          "name"
        ],
        "title": "CreateApiKeyRequest",
        "description": "Request to create a new API key."
      },
      "CreateApiKeyResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "key": {
            "type": "string",
            "title": "Key",
            "description": "The raw API key — store it securely, it cannot be retrieved again"
          },
          "keyPrefix": {
            "type": "string",
            "title": "Keyprefix"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Createdat"
          },
          "expiresAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expiresat"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "key",
          "keyPrefix",
          "createdAt"
        ],
        "title": "CreateApiKeyResponse",
        "description": "Response after creating an API key. Contains the raw key (shown only once)."
      },
      "CreatePipelineDTO": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Name",
            "description": "Pipeline name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description",
            "description": "Optional pipeline description"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags",
            "description": "Arbitrary string tags for categorization"
          },
          "id": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id",
            "description": "Optional client-generated pipeline ID (must be a valid lowercase UUID v4)"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "name"
        ],
        "title": "CreatePipelineDTO",
        "description": "Request body for creating a new pipeline."
      },
      "DashboardStatus": {
        "type": "string",
        "enum": [
          "active",
          "archived"
        ],
        "title": "DashboardStatus"
      },
      "ExcludedExample": {
        "properties": {
          "symbol": {
            "type": "string",
            "title": "Symbol"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "marketCapUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Marketcapusd"
          },
          "detail": {
            "type": "string",
            "title": "Detail"
          }
        },
        "type": "object",
        "required": [
          "symbol",
          "name",
          "marketCapUsd",
          "detail"
        ],
        "title": "ExcludedExample",
        "description": "One issuer left out (or flagged) under a reason.\n\nAttributes:\n    symbol: The line that would have represented the issuer.\n    name: The listing name.\n    market_cap_usd: The line's latest USD market cap, when known.\n    detail: Why this line, in the reason's terms: its venue, domicile, industry,\n        security-type rule, rank position, or the returned line (\"kept GOOGL\")."
      },
      "ExclusionCount": {
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "venue",
              "domicile",
              "class_neighbour",
              "common_stock",
              "adr",
              "etf",
              "mutual_fund",
              "closed_end_fund",
              "preferred",
              "debt",
              "warrant",
              "unit",
              "right",
              "other",
              "duplicate_line",
              "no_rank_value",
              "market_cap_band",
              "below_rank_cutoff",
              "code_filter"
            ],
            "title": "Reason"
          },
          "count": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Count"
          },
          "examples": {
            "items": {
              "$ref": "#/components/schemas/ExcludedExample"
            },
            "type": "array",
            "maxItems": 5,
            "title": "Examples"
          },
          "label": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 120
              },
              {
                "type": "null"
              }
            ],
            "title": "Label"
          }
        },
        "type": "object",
        "required": [
          "reason",
          "count"
        ],
        "title": "ExclusionCount",
        "description": "How many issuers one reason excluded, with up to five examples.\n\nAttributes:\n    reason: Why they were excluded.\n    count: Issuers excluded for this reason alone.\n    examples: The most telling issuers, in the reason's example order.\n    label: The caller's description of a `code_filter`; None for helper reasons."
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "KeptFlagCount": {
        "properties": {
          "flag": {
            "type": "string",
            "enum": [
              "adr",
              "non_us_domicile",
              "no_market_cap"
            ],
            "title": "Flag"
          },
          "count": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Count"
          },
          "examples": {
            "items": {
              "$ref": "#/components/schemas/ExcludedExample"
            },
            "type": "array",
            "maxItems": 5,
            "title": "Examples"
          }
        },
        "type": "object",
        "required": [
          "flag",
          "count"
        ],
        "title": "KeptFlagCount",
        "description": "How many returned members carry one flag, with up to five of the largest."
      },
      "ListingFilters": {
        "properties": {
          "activeOnly": {
            "type": "boolean",
            "title": "Activeonly"
          },
          "venues": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Venues"
          },
          "excludeVenues": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excludevenues"
          },
          "domiciles": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domiciles"
          },
          "venuesDefaulted": {
            "type": "boolean",
            "title": "Venuesdefaulted"
          },
          "domicilesDefaulted": {
            "type": "boolean",
            "title": "Domicilesdefaulted"
          },
          "marketCap": {
            "$ref": "#/components/schemas/MarketCapBand"
          }
        },
        "type": "object",
        "required": [
          "activeOnly",
          "venues",
          "excludeVenues",
          "domiciles",
          "venuesDefaulted",
          "domicilesDefaulted",
          "marketCap"
        ],
        "title": "ListingFilters",
        "description": "Where listings trade, where issuers are domiciled, and the market-cap band.\n\nAttributes:\n    active_only: Only currently listed securities were considered.\n    venues: Venues a listing had to trade on; None is no venue restriction.\n    exclude_venues: Venues that excluded a listing; None is none.\n    domiciles: Issuer country codes kept; None keeps every domicile.\n    venues_defaulted: The caller did not choose venues, so the helper's legacy\n        default (no venue filter) applied.\n    domiciles_defaulted: The caller did not choose a domicile, so the helper's\n        legacy default applied: US-domiciled for the list helper, every country\n        for the top-N helper.\n    market_cap: The USD market-cap band."
      },
      "LiveArtifactDataDTO": {
        "properties": {
          "liveArtifactId": {
            "type": "string",
            "title": "Liveartifactid"
          },
          "columns": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Columns"
          },
          "rows": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Rows"
          },
          "returnedRows": {
            "type": "integer",
            "title": "Returnedrows"
          },
          "totalRows": {
            "type": "integer",
            "title": "Totalrows"
          },
          "offset": {
            "type": "integer",
            "title": "Offset"
          },
          "truncated": {
            "type": "boolean",
            "title": "Truncated"
          },
          "storageBytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Storagebytes",
            "description": "Compressed on-disk size of the authoritative backing store in bytes, when available."
          }
        },
        "type": "object",
        "required": [
          "liveArtifactId",
          "columns",
          "rows",
          "returnedRows",
          "totalRows",
          "offset",
          "truncated"
        ],
        "title": "LiveArtifactDataDTO",
        "description": "DTO for row data downloaded from a LiveArtifact's authoritative store."
      },
      "LiveArtifactWrite": {
        "properties": {
          "stableId": {
            "type": "string",
            "title": "Stableid"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "rowsWritten": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Rowswritten",
            "default": 0
          }
        },
        "type": "object",
        "required": [
          "stableId"
        ],
        "title": "LiveArtifactWrite",
        "description": "Rows one WorkflowRun wrote to one LiveArtifact."
      },
      "MarketCapBand": {
        "properties": {
          "minUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Minusd"
          },
          "maxUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maxusd"
          },
          "comparisonOperator": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  ">",
                  ">=",
                  "<",
                  "<="
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Comparisonoperator"
          },
          "comparisonValue": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comparisonvalue"
          }
        },
        "type": "object",
        "title": "MarketCapBand",
        "description": "The USD market-cap band applied after the issuer dedup; all None means no band."
      },
      "NameCoverage": {
        "properties": {
          "overflowed": {
            "type": "boolean",
            "title": "Overflowed",
            "default": false
          },
          "askedCount": {
            "type": "integer",
            "title": "Askedcount",
            "description": "Distinct names the run's reads of this source asked for.",
            "readOnly": true
          },
          "withItemsCount": {
            "type": "integer",
            "title": "Withitemscount",
            "description": "Asked names that returned at least one item.",
            "readOnly": true
          }
        },
        "type": "object",
        "required": [
          "askedCount",
          "withItemsCount"
        ],
        "title": "NameCoverage",
        "description": "Which of the names a source was asked for returned at least one item during one WorkflowRun.\n\nA name is a company (a ticker, in ``normalize_share_class_symbol`` form) or a\nkeyword (casefolded). Reads merge by name (``merge_name_coverage``), so a\nname read twice, by two calls or two nodes, counts once.\n\nThe two name lists are internal: the headline check and the report node's\nprompt read them, and the persisted record keeps them\n(``dump_check_summary``), but every other serialization, the run API DTOs\nincluded, carries only the counts. Shared pipelines' runs are visible to\nreaders other than the owner, and no reader uses the lists."
      },
      "PipelineFileInput": {
        "properties": {
          "fileArtifactId": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Fileartifactid",
            "description": "A document Artifact a file trigger delivered, or the Artifact of a Knowledge Base upload."
          },
          "knowledgeBaseDocumentId": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Knowledgebasedocumentid",
            "description": "A Knowledge Base document id from Knowledge Base search. Only uploaded documents qualify."
          },
          "triggerLogicalId": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 256,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Triggerlogicalid",
            "description": "The file trigger that receives the document. Needed only when the Pipeline has several."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "PipelineFileInput",
        "description": "The document a manual run delivers to a file-started Pipeline's file trigger.\n\nExactly one of ``file_artifact_id`` and ``knowledge_base_document_id``.\n``pipeline_file_input.resolve_file_input_payload`` turns it into the\ntrigger's row."
      },
      "PipelineStatus": {
        "type": "string",
        "enum": [
          "active",
          "archived"
        ],
        "title": "PipelineStatus"
      },
      "PipelineSummaryDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "ownerConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ownerconversationid",
            "description": "Owning Builder conversation for the selected oldest unarchived Pipeline; null for other rows."
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updatedat"
          },
          "parentPipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parentpipelineid"
          },
          "projectIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Projectids"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "title": "PipelineSummaryDTO",
        "description": "Lightweight pipeline representation for quick listing (e.g. sidebar nav).\n\nNote: ``updated_at`` is a computed last-activity timestamp (GREATEST of\npipeline, conversation, and module-run timestamps) — not the raw DB column.\n\n``description`` is included so the pipeline page header (title + subtitle)\ncan paint instantly from the sidebar's localStorage-backed summary cache,\navoiding a network round-trip on navigation.\n\n``parent_pipeline_id`` is included so listing surfaces (sidebar dropdown,\nconversation grouping, etc.) can hide subpipelines, which are surfaced in\nthe context of their parent rather than as standalone top-level pipelines."
      },
      "PipelineTickerPageDTO": {
        "properties": {
          "pageId": {
            "type": "string",
            "title": "Pageid"
          },
          "symbol": {
            "type": "string",
            "title": "Symbol"
          }
        },
        "type": "object",
        "required": [
          "pageId",
          "symbol"
        ],
        "title": "PipelineTickerPageDTO",
        "description": "An owned, active Ticker page associated with a listed Pipeline."
      },
      "PipelineTriggerCheckDTO": {
        "properties": {
          "triggerId": {
            "type": "string",
            "title": "Triggerid"
          },
          "checkedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Checkedat"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "no_change",
              "matched",
              "failed",
              "unknown"
            ],
            "title": "Outcome"
          },
          "failureReason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Failurereason"
          }
        },
        "type": "object",
        "required": [
          "triggerId",
          "checkedAt",
          "outcome"
        ],
        "title": "PipelineTriggerCheckDTO",
        "description": "A source check, independent of whether it started a Pipeline run."
      },
      "PipelineTriggerScheduleDTO": {
        "properties": {
          "triggerId": {
            "type": "string",
            "title": "Triggerid"
          },
          "triggerLogicalId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Triggerlogicalid"
          },
          "webMode": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WebTriggerMode"
              },
              {
                "type": "null"
              }
            ]
          },
          "sourceUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceurl"
          },
          "triggerKind": {
            "type": "string",
            "enum": [
              "time",
              "code",
              "web",
              "file",
              "live_artifact",
              "knowledge_base",
              "dataset",
              "result"
            ],
            "title": "Triggerkind"
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "state": {
            "type": "string",
            "enum": [
              "scheduled",
              "conditional",
              "event",
              "paused",
              "invalid"
            ],
            "title": "State"
          },
          "timezone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timezone"
          },
          "hasCondition": {
            "type": "boolean",
            "title": "Hascondition",
            "default": false
          },
          "scheduleType": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "cron",
                  "times",
                  "invalid"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Scheduletype"
          },
          "cronExpression": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cronexpression"
          },
          "times": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Times"
          },
          "issue": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issue"
          },
          "checkIntervalSeconds": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Checkintervalseconds"
          },
          "lastCheckedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastcheckedat"
          },
          "lastCheckOutcome": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "no_change",
                  "matched",
                  "failed",
                  "unknown"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastcheckoutcome"
          },
          "nextOccurrenceAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Nextoccurrenceat",
            "description": "Compute at serialization time so cached configurations do not freeze time.\n\nCached DTOs reconstruct this property from the non-executable schedule\nfields. A condition check is an opportunity, never a promised execution.",
            "readOnly": true
          }
        },
        "type": "object",
        "required": [
          "triggerId",
          "triggerKind",
          "summary",
          "state",
          "nextOccurrenceAt"
        ],
        "title": "PipelineTriggerScheduleDTO",
        "description": "One active-revision or paused trigger and its next calendar opportunity."
      },
      "QuestionAnswerItem": {
        "properties": {
          "questionIndex": {
            "type": "integer",
            "title": "Questionindex",
            "description": "Index of the question this answer is for (0-based)",
            "default": 0
          },
          "selectedOptions": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Selectedoptions"
          },
          "textAnswer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Textanswer",
            "description": "Free-form text answer"
          }
        },
        "type": "object",
        "title": "QuestionAnswerItem",
        "description": "A single answer to a question in an AskUserQuestion form."
      },
      "QuestionResponseRequest": {
        "properties": {
          "formId": {
            "type": "string",
            "title": "Formid",
            "description": "The `formId` value from the question event"
          },
          "answers": {
            "items": {
              "$ref": "#/components/schemas/QuestionAnswerItem"
            },
            "type": "array",
            "title": "Answers",
            "description": "Answers to each question"
          }
        },
        "type": "object",
        "required": [
          "formId",
          "answers"
        ],
        "title": "QuestionResponseRequest",
        "description": "Request to respond to a pending agent question."
      },
      "RankDefinition": {
        "properties": {
          "metric": {
            "type": "string",
            "enum": [
              "market_cap",
              "pe_ratio"
            ],
            "title": "Metric"
          },
          "direction": {
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ],
            "title": "Direction"
          },
          "n": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "N"
          }
        },
        "type": "object",
        "required": [
          "metric",
          "direction",
          "n"
        ],
        "title": "RankDefinition",
        "description": "The ordering a helper applied and where it cut.\n\nAttributes:\n    metric: The ranking metric. The list helper orders by USD market cap.\n    direction: \"desc\" keeps the largest values.\n    n: The row cap; None returns every qualifying company."
      },
      "ReportPresentation": {
        "properties": {
          "kinds": {
            "items": {
              "type": "string",
              "enum": [
                "requested_once",
                "historical_example"
              ]
            },
            "type": "array",
            "title": "Kinds"
          },
          "source_date": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Date"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "ReportPresentation",
        "description": "Labels beside a report's delivery date, separate from its finding title."
      },
      "SectorPhraseMatch": {
        "properties": {
          "phrase": {
            "type": "string",
            "title": "Phrase"
          },
          "method": {
            "type": "string",
            "enum": [
              "fmp_sector",
              "model",
              "model_fallback",
              "model_empty"
            ],
            "title": "Method"
          },
          "sectors": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Sectors",
            "default": []
          },
          "industries": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Industries",
            "default": []
          }
        },
        "type": "object",
        "required": [
          "phrase",
          "method"
        ],
        "title": "SectorPhraseMatch",
        "description": "How a universe helper resolved its `sector_search_phrase` into a listing filter.\n\nAttributes:\n    phrase: The phrase as the helper received it, with list phrases joined by \", \".\n    method: \"fmp_sector\" when every part named an FMP sector exactly and the helper\n        filters `equity_metadata.sector`; \"model\" when the industry matcher chose\n        industries and the helper filters `equity_metadata.industry`;\n        \"model_fallback\" when the matcher's answer is not a known industry (it\n        answers with the phrase itself after an error), so the industry filter\n        uses that answer; \"model_empty\" when the matcher chose no industries, so\n        no sector or industry filter applies and the whole market passes.\n    sectors: The FMP sectors filtered on; empty except on the sector path.\n    industries: The industries the matcher answered with; empty on the sector path."
      },
      "SecuritySelection": {
        "properties": {
          "universe": {
            "type": "string",
            "enum": [
              "operating_equity",
              "all"
            ],
            "title": "Universe"
          },
          "etfs": {
            "type": "string",
            "enum": [
              "yes",
              "no",
              "only etfs"
            ],
            "title": "Etfs"
          },
          "tickers": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tickers"
          }
        },
        "type": "object",
        "required": [
          "universe",
          "etfs",
          "tickers"
        ],
        "title": "SecuritySelection",
        "description": "Which security types formed the universe.\n\nAttributes:\n    universe: \"operating_equity\" (common stock and ADRs) or \"all\". Explicit tickers\n        force \"all\".\n    etfs: The ETF choice applied on top of `universe`.\n    tickers: The exact symbols requested, when the caller named them."
      },
      "ShareClassHandling": {
        "properties": {
          "issuerKey": {
            "type": "string",
            "enum": [
              "listing_name",
              "symbol"
            ],
            "title": "Issuerkey"
          },
          "tieBreak": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tiebreak",
            "default": [
              "operating_equity_type",
              "undotted_symbol",
              "known_market_cap",
              "dollar_volume",
              "market_cap",
              "symbol"
            ]
          }
        },
        "type": "object",
        "required": [
          "issuerKey"
        ],
        "title": "ShareClassHandling",
        "description": "The rule behind every merge of an issuer's lines.\n\nAttributes:\n    issuer_key: \"listing_name\" folds the listing name's punctuation and case into\n        one issuer; \"symbol\" keeps every requested ticker as its own issuer.\n    tie_break: The dedup's ordering of an issuer's lines, first key first."
      },
      "SourceCheck": {
        "properties": {
          "source": {
            "$ref": "#/components/schemas/CheckedSource"
          },
          "calls": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Calls",
            "default": 0
          },
          "failedCalls": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Failedcalls",
            "default": 0
          },
          "items": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Items",
            "default": 0
          },
          "newestItemAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Newestitemat"
          },
          "newestItemPrecision": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "date",
                  "datetime"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Newestitemprecision"
          },
          "currentWindowCalls": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Currentwindowcalls",
            "default": 0
          },
          "lastCheckedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lastcheckedat"
          },
          "stale": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stale"
          },
          "archiveWatermarkCalls": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Archivewatermarkcalls",
            "default": 0
          },
          "archiveWatermarkAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archivewatermarkat"
          },
          "companies": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NameCoverage"
              },
              {
                "type": "null"
              }
            ]
          },
          "keywords": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NameCoverage"
              },
              {
                "type": "null"
              }
            ]
          },
          "unnamedItemCalls": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Unnameditemcalls",
            "default": 0
          }
        },
        "type": "object",
        "required": [
          "source"
        ],
        "title": "SourceCheck",
        "description": "Aggregated reads of one source during one WorkflowRun."
      },
      "SystematicCodeRepairAttemptDTO": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "incidentId": {
            "type": "string",
            "title": "Incidentid"
          },
          "generation": {
            "type": "integer",
            "title": "Generation"
          },
          "route": {
            "$ref": "#/components/schemas/SystematicCodeRepairRoute"
          },
          "state": {
            "$ref": "#/components/schemas/SystematicCodeRepairState"
          },
          "invocationHostPipelineId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Invocationhostpipelineid"
          },
          "invocationHostWorkflowRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Invocationhostworkflowrunid"
          },
          "sourceWorkflowRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourceworkflowrunid"
          },
          "sourceModuleRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sourcemodulerunid"
          },
          "repairConversationId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Repairconversationid"
          },
          "repairModuleRunId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Repairmodulerunid"
          },
          "replacementParameterizedWorkflowId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Replacementparameterizedworkflowid"
          },
          "capabilityVersion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capabilityversion"
          },
          "terminalReasonCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Terminalreasoncode"
          },
          "ownerOverrideRequestedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Owneroverriderequestedat"
          },
          "rearmReason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SystematicCodeRepairRearmReason"
              },
              {
                "type": "null"
              }
            ]
          },
          "validationResult": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SystematicCodeRepairValidationResult"
              },
              {
                "type": "null"
              }
            ]
          },
          "validationWorkflowRunIds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Validationworkflowrunids"
          },
          "activatedOwnerVersionId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Activatedownerversionid"
          }
        },
        "type": "object",
        "required": [
          "id",
          "incidentId",
          "generation",
          "route",
          "state"
        ],
        "title": "SystematicCodeRepairAttemptDTO",
        "description": "Privacy-safe automatic-repair lifecycle exposed with run and Pipeline status."
      },
      "SystematicCodeRepairRearmReason": {
        "type": "string",
        "enum": [
          "new_active_revision",
          "fingerprint_changed",
          "owner_override",
          "capability_upgrade"
        ],
        "title": "SystematicCodeRepairRearmReason",
        "description": "Policy-approved reasons an incident may receive another repair claim."
      },
      "SystematicCodeRepairRoute": {
        "type": "string",
        "enum": [
          "pipeline_builder",
          "unsupported"
        ],
        "title": "SystematicCodeRepairRoute",
        "description": "Typed repair destination selected from executable ownership."
      },
      "SystematicCodeRepairState": {
        "type": "string",
        "enum": [
          "observed",
          "circuit_open",
          "repair_claimed",
          "repair_launched",
          "diagnosed_no_change",
          "patch_applied",
          "validation_passed",
          "activated",
          "failed"
        ],
        "title": "SystematicCodeRepairState",
        "description": "Durable automatic-repair lifecycle."
      },
      "SystematicCodeRepairValidationResult": {
        "type": "string",
        "enum": [
          "passed",
          "failed"
        ],
        "title": "SystematicCodeRepairValidationResult",
        "description": "Bounded representative validation outcome."
      },
      "UniverseCheck": {
        "properties": {
          "moduleId": {
            "type": "string",
            "title": "Moduleid"
          },
          "callIndex": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Callindex"
          },
          "record": {
            "$ref": "#/components/schemas/UniverseRecord"
          }
        },
        "type": "object",
        "required": [
          "moduleId",
          "callIndex",
          "record"
        ],
        "title": "UniverseCheck",
        "description": "One universe-helper call a Pipeline node made during a WorkflowRun.\n\nAttributes:\n    module_id: The node (module) whose code made the call.\n    call_index: The call's position among that node's recorded calls in its latest\n        execution, from 0. A re-executed node replaces its earlier calls.\n    record: What the call applied, returned and left out."
      },
      "UniverseRecord": {
        "properties": {
          "schemaVersion": {
            "type": "integer",
            "const": 1,
            "title": "Schemaversion",
            "default": 1
          },
          "helper": {
            "type": "string",
            "enum": [
              "get_company_list",
              "get_top_companies_by_metric"
            ],
            "title": "Helper"
          },
          "definition": {
            "$ref": "#/components/schemas/AppliedDefinition"
          },
          "definitionHash": {
            "type": "string",
            "title": "Definitionhash"
          },
          "memberCount": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Membercount"
          },
          "requestedN": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Requestedn"
          },
          "shortfall": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Shortfall"
          },
          "exclusions": {
            "items": {
              "$ref": "#/components/schemas/ExclusionCount"
            },
            "type": "array",
            "title": "Exclusions"
          },
          "keptFlags": {
            "items": {
              "$ref": "#/components/schemas/KeptFlagCount"
            },
            "type": "array",
            "title": "Keptflags"
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Recordedat"
          }
        },
        "type": "object",
        "required": [
          "helper",
          "definition",
          "definitionHash",
          "memberCount",
          "requestedN",
          "shortfall",
          "exclusions",
          "keptFlags",
          "recordedAt"
        ],
        "title": "UniverseRecord",
        "description": "What one universe helper call applied, returned and left out.\n\nAttributes:\n    schema_version: Bumped when the record's shape changes.\n    helper: The helper that produced it.\n    definition: The resolved definition.\n    definition_hash: A short hash of the definition without its dates, so runs and\n        builds can tell \"same definition, different data\" from \"different definition\".\n    member_count: Rows returned.\n    requested_n: The row cap requested; None without one.\n    shortfall: How many fewer rows than `requested_n` came back.\n    exclusions: Issuers left out, per reason, largest count first.\n    kept_flags: Returned members carrying a flag, per flag, largest count first.\n    recorded_at: When the record was built (UTC). A cache hit returns the original."
      },
      "UpdatePipelineDTO": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Name",
            "description": "New pipeline name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description",
            "description": "New pipeline description"
          },
          "tags": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tags",
            "description": "Replace tags list"
          }
        },
        "type": "object",
        "title": "UpdatePipelineDTO",
        "description": "Request body for updating pipeline name or description."
      },
      "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"
      },
      "WebTriggerMode": {
        "type": "string",
        "enum": [
          "events",
          "feed",
          "page"
        ],
        "title": "WebTriggerMode",
        "description": "What a web trigger watches: a Parallel event-stream query, a feed, or one page."
      },
      "WorkItemStatusDTO": {
        "properties": {
          "state": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "working",
                  "needs_you",
                  "failed",
                  "ready"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "State"
          },
          "readyAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Readyat"
          },
          "conversationFailed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversationfailed"
          }
        },
        "type": "object",
        "title": "WorkItemStatusDTO",
        "description": "One item's current state and the time of its latest usable result."
      },
      "WorkflowRunCheckSummary": {
        "properties": {
          "version": {
            "type": "integer",
            "title": "Version",
            "default": 1
          },
          "sources": {
            "items": {
              "$ref": "#/components/schemas/SourceCheck"
            },
            "type": "array",
            "title": "Sources"
          },
          "universes": {
            "items": {
              "$ref": "#/components/schemas/UniverseCheck"
            },
            "type": "array",
            "title": "Universes"
          },
          "liveArtifacts": {
            "items": {
              "$ref": "#/components/schemas/LiveArtifactWrite"
            },
            "type": "array",
            "title": "Liveartifacts"
          },
          "reportsPublished": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Reportspublished",
            "default": 0
          },
          "filesDelivered": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Filesdelivered"
          },
          "sealedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sealedat"
          },
          "sealedStatus": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "completed",
                  "failed",
                  "cancelled"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Sealedstatus"
          }
        },
        "type": "object",
        "title": "WorkflowRunCheckSummary",
        "description": "What a WorkflowRun read, what it produced, and whether its sources were current."
      }
    },
    "securitySchemes": {
      "apiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "API key created in the Mana web app. Use for authenticated public API calls."
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Mana web app session token, used only by the API-key management endpoints. Other endpoints also accept an API key as `Authorization: Bearer mana_...`."
      }
    }
  },
  "servers": [
    {
      "url": "https://backend-alpha.mana.ai",
      "description": "Production"
    }
  ]
}
