components:
  schemas:
    APINotificationSettings:
      description: API channel settings with connection settings for AcquisitionExecutor.
      properties:
        channel_slug:
          const: api
          default: api
          title: Channel Slug
          type: string
        connection_settings:
          $ref: '#/components/schemas/AcquisitionExecutorInputArgsDTO'
      required:
      - connection_settings
      title: APINotificationSettings
      type: object
    AccessPolicyCreateDTO:
      additionalProperties: false
      description: DTO for creating a new AccessPolicy.
      properties:
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        resource_ref:
          title: Resource Ref
          type: string
      required:
      - resource_ref
      title: AccessPolicyCreateDTO
      type: object
    AccessPolicyResponseDTO:
      description: DTO for AccessPolicy API responses.
      properties:
        created_at:
          format: date-time
          title: Created At
          type: string
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        resource_ref:
          title: Resource Ref
          type: string
      required:
      - resource_ref
      - created_at
      title: AccessPolicyResponseDTO
      type: object
    AccessPolicyUpdateDTO:
      additionalProperties: false
      description: DTO for updating an AccessPolicy.
      properties:
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
      title: AccessPolicyUpdateDTO
      type: object
    AcquireWorkflowInputArgsDTO:
      properties:
        connection_settings:
          $ref: '#/components/schemas/AcquisitionExecutorInputArgsDTO'
      required:
      - connection_settings
      title: AcquireWorkflowInputArgsDTO
      type: object
    AcquisitionExecutorInputArgsDTO:
      properties:
        auth:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Auth
        body:
          anyOf:
          - {}
          - type: 'null'
          title: Body
        headers:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Headers
        inline_data:
          anyOf:
          - {}
          - type: 'null'
          title: Inline Data
        method:
          title: Method
          type: string
        query_params:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Query Params
        retries:
          default: 2
          title: Retries
          type: integer
        retry_delay:
          default: 1
          title: Retry Delay
          type: integer
        timeout:
          default: 30
          title: Timeout
          type: integer
        url:
          anyOf:
          - type: string
          - type: 'null'
          title: Url
      required:
      - url
      - method
      title: AcquisitionExecutorInputArgsDTO
      type: object
    AgenticInputPayloadExtractionParameters:
      properties:
        entity_mapping:
          description: Entity mapping configuration for the input payload; may be
            auto-derived later
          items:
            $ref: '#/components/schemas/EntityMapping'
          title: Entity Mapping
          type: array
        persist_settings:
          description: Settings describing how input entities should be persisted,
            this version is not requesting target_workspace_id intentionally during
            agentic process, target workspace_id is not ready at trigger time
          items:
            $ref: '#/components/schemas/AgenticPersistSettings'
          title: Persist Settings
          type: array
      required:
      - entity_mapping
      - persist_settings
      title: AgenticInputPayloadExtractionParameters
      type: object
    AgenticInputPayloadExtractionTypesEnum:
      enum:
      - auto
      - predefined
      title: AgenticInputPayloadExtractionTypesEnum
      type: string
    AgenticPersistSettings:
      additionalProperties: true
      properties:
        mapping_group_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Mapping Group Slug
        node_deduplication_fields:
          items:
            type: string
          title: Node Deduplication Fields
          type: array
        relationship:
          anyOf:
          - type: string
          - type: 'null'
          title: Relationship
        source_entity_selection_expression:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Source Entity Selection Expression
      title: AgenticPersistSettings
      type: object
    AgenticWorkflowInputArgs:
      allOf:
      - if:
          properties:
            input_extraction_mode:
              const: manual
          required:
          - input_extraction_mode
        then:
          required:
          - manual_input_extraction_parameters
      properties:
        available_qualified_entity_names:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: ''
          title: Available Qualified Entity Names
        debug_min_cycles_to_be_executed:
          default: 128
          description: Stops at nth cycle
          title: Debug Min Cycles To Be Executed
          type: integer
        debug_mode_enabled:
          default: false
          description: Enables agentic workflow debug mode
          title: Debug Mode Enabled
          type: boolean
        enable_internal_test_tools:
          anyOf:
          - type: boolean
          - type: 'null'
          default: false
          description: Enables all internal test tools to be parsed to the context.
            Might be reduced by exclusively_enabled_test_tools
          title: Enable Internal Test Tools
        exclusively_enabled_external_tools:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List fully qualified names of exclusively enabled tools loaded
            from external sources. If list is empty = toolset is disabled.
          title: Exclusively Enabled External Tools
        exclusively_enabled_internal_tools:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List fully qualified names of exclusively enabled internal
            tools. If list is empty = toolset is disabled.
          title: Exclusively Enabled Internal Tools
        exclusively_enabled_test_tools:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List fully qualified names of exclusively enabled test tools.
            If list is empty = toolset is disabled.
          title: Exclusively Enabled Test Tools
        failure_criteria:
          description: Optional logic or string describing what constitutes a failure
            in execution
          title: Failure Criteria
          type: string
        goal:
          description: Explicit objective or instruction the agent should attempt
            to fulfill
          title: Goal
          type: string
        inline_mcp_toolset:
          anyOf:
          - items: {}
            type: array
          - type: 'null'
          description: Explicitly provided toolset definitions; optional if tools
            are downloaded remotely
          title: Inline Mcp Toolset
        input_extraction_mode:
          $ref: '#/components/schemas/AgenticInputPayloadExtractionTypesEnum'
          default: predefined
          description: Specifies how input_payload extraction is expected by the user
            to be performed
        input_payload:
          anyOf:
          - {}
          - type: 'null'
          description: Initial payload passed to the agentic process; can be any structure
          title: Input Payload
        llm_settings:
          $ref: '#/components/schemas/LLMInvokerExecutorSettingsDTO'
          description: Configuration for which LLM engine to use (e.g., OpenAI)
        manual_input_extraction_parameters:
          anyOf:
          - $ref: '#/components/schemas/AgenticInputPayloadExtractionParameters'
          - type: 'null'
        max_failure_count_per_tool:
          default: 10
          description: Will ban the tool from being invoked if exceeds this number
          title: Max Failure Count Per Tool
          type: integer
        max_failure_count_total:
          default: 10
          description: Will fail the agentic process if tool invocation failure rate
            exceeds this number
          title: Max Failure Count Total
          type: integer
        notification_targets:
          anyOf:
          - items:
              $ref: '#/components/schemas/NotificationTargets'
            type: array
          - type: 'null'
          description: Optional list of notification targets where notifications will
            be sent on workflow completion
          title: Notification Targets
        origin_source:
          anyOf:
          - $ref: '#/components/schemas/OriginSourceDescriptor'
          - type: 'null'
          description: Optional origin source metadata for notifications
        remote_mcp_toolset_endpoints:
          anyOf:
          - items:
              $ref: '#/components/schemas/AcquisitionExecutorInputArgsDTO'
            type: array
          - type: 'null'
          description: List of HTTP endpoints where the agent should download tool
            definitions from
          title: Remote Mcp Toolset Endpoints
        return_schema:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: JSON schema string defining how the final response should be
            formatted (e.g., {"threat":"bool"})
          title: Return Schema
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional identifier for grouping multiple related sessions
            (e.g., webhook configuration)
          title: Session Group Id
        session_name:
          anyOf:
          - type: string
          - type: 'null'
          default: Investigation
          description: Optional session label used for naming root node; defaults
            to 'Investigation'
          title: Session Name
        session_type:
          default: alert
          description: Classifier used in naming graph workspace; useful for grouping
            sessions
          title: Session Type
          type: string
        shared_group_id:
          anyOf:
          - type: string
          - type: 'null'
          description: When provided, shared_group_id is used to organize data and
            load essential configuration
          title: Shared Group Id
        success_criteria:
          description: Optional logic or string describing what constitutes successful
            completion of the goal
          title: Success Criteria
          type: string
        timeout_seconds:
          default: 60
          description: Maximum allowed duration (in seconds) for the agentic process
            to run
          title: Timeout Seconds
          type: integer
        upsert_root_uuid:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional predefined root node UUID; if omitted, a new one will
            be generated
          title: Upsert Root Uuid
        upsert_workspace_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional predefined host UUID; if omitted, a new one will be
            generated
          title: Upsert Workspace Id
      required:
      - goal
      - success_criteria
      - failure_criteria
      - llm_settings
      title: AgenticWorkflowInputArgs
      type: object
    ArtifactCreateDTO:
      additionalProperties: false
      description: DTO for creating a new Artifact.
      properties:
        artifact_category:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Category
        classification:
          anyOf:
          - type: string
          - type: 'null'
          title: Classification
        hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Hash
        origin:
          title: Origin
          type: string
        producer_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
        producer_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Resource Refs
        tags:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tags
      required:
      - origin
      title: ArtifactCreateDTO
      type: object
    ArtifactResponseDTO:
      description: DTO for Artifact API responses.
      properties:
        artifact_category:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Category
        artifact_id:
          title: Artifact Id
          type: string
        classification:
          anyOf:
          - type: string
          - type: 'null'
          title: Classification
        commit_state:
          $ref: '#/components/schemas/CommitStatesEnum'
        created_at:
          format: date-time
          title: Created At
          type: string
        hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Hash
        origin:
          title: Origin
          type: string
        producer_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
        producer_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        tags:
          items:
            type: string
          title: Tags
          type: array
        team_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Team Id
        updated_at:
          format: date-time
          title: Updated At
          type: string
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
      required:
      - artifact_id
      - origin
      - commit_state
      - created_at
      - updated_at
      title: ArtifactResponseDTO
      type: object
    ArtifactUpdateDTO:
      additionalProperties: false
      description: DTO for updating an Artifact (partial update).
      properties:
        artifact_category:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Category
        classification:
          anyOf:
          - type: string
          - type: 'null'
          title: Classification
        commit_state:
          anyOf:
          - $ref: '#/components/schemas/CommitStatesEnum'
          - type: 'null'
        hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Hash
        producer_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
        producer_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Resource Refs
        tags:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tags
      title: ArtifactUpdateDTO
      type: object
    AvailableWorkflowDescriptor:
      properties:
        arguments_schema:
          additionalProperties: true
          title: Arguments Schema
          type: object
        nicename:
          title: Nicename
          type: string
        slug:
          title: Slug
          type: string
      required:
      - slug
      - nicename
      - arguments_schema
      title: AvailableWorkflowDescriptor
      type: object
    CheckNotificationDestinationDTO:
      properties:
        notification_target:
          $ref: '#/components/schemas/NotificationTargets'
          description: The notification target configuration to test
      required:
      - notification_target
      title: CheckNotificationDestinationDTO
      type: object
    CheckNotificationResultDTO:
      properties:
        channel_slug:
          description: The notification channel that was tested
          title: Channel Slug
          type: string
        error:
          anyOf:
          - type: string
          - type: 'null'
          description: Error message if the test failed
          title: Error
        status_code:
          anyOf:
          - type: integer
          - type: 'null'
          description: HTTP status code from the notification destination (if applicable)
          title: Status Code
        success:
          description: Whether the test notification was sent successfully
          title: Success
          type: boolean
      required:
      - success
      - channel_slug
      title: CheckNotificationResultDTO
      type: object
    ChunkSettings:
      description: Configuration for document chunking
      properties:
        chunk_size:
          default: 1000
          description: Maximum chunk size in characters
          maximum: 10000.0
          minimum: 100.0
          title: Chunk Size
          type: integer
        overlap:
          default: 100
          description: Overlap between chunks in characters
          maximum: 500.0
          minimum: 0.0
          title: Overlap
          type: integer
        strategy:
          default: fixed_size
          description: 'Chunking strategy: sentence_boundary, fixed_size, paragraph,
            whole_document'
          title: Strategy
          type: string
      title: ChunkSettings
      type: object
    CommitStatesEnum:
      description: 'Commit state for governance objects.


        - PROVISIONED: Created but not yet visible to consumers

        - COMMITTED: Visible to consumers'
      enum:
      - provisioned
      - streaming
      - committed
      title: CommitStatesEnum
      type: string
    ConsolidatedFeatureResponse:
      properties:
        feature_type:
          default: consolidated
          enum:
          - consolidated
          - temporal
          title: Feature Type
          type: string
        updated_ts:
          anyOf:
          - type: string
          - type: 'null'
          title: Updated Ts
        value:
          additionalProperties: true
          default: {}
          title: Value
          type: object
      title: ConsolidatedFeatureResponse
      type: object
    ContentFormatEnum:
      description: Format of content in a materialization.
      enum:
      - raw
      - binary
      - encoded
      title: ContentFormatEnum
      type: string
    ContentScopeEnum:
      description: Scope of content in a materialization.
      enum:
      - partial
      - full
      title: ContentScopeEnum
      type: string
    ContributingTaskItemModel:
      properties:
        task_description:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Description
        task_error:
          anyOf:
          - {}
          - type: 'null'
          title: Task Error
        task_id:
          title: Task Id
          type: string
        task_name:
          title: Task Name
          type: string
        task_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Slug
        task_status:
          title: Task Status
          type: string
        task_token:
          title: Task Token
          type: string
        workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Id
      required:
      - task_id
      - task_name
      - task_token
      - task_status
      title: ContributingTaskItemModel
      type: object
    CreateExternalAlertsInputDTO:
      properties:
        alerts:
          items:
            $ref: '#/components/schemas/ExternalAlertItemDTO'
          maxItems: 100
          minItems: 1
          title: Alerts
          type: array
      required:
      - alerts
      title: CreateExternalAlertsInputDTO
      type: object
    CreateExternalAlertsResultDTO:
      properties:
        alert_uuids:
          items:
            type: string
          title: Alert Uuids
          type: array
        alerts_created:
          title: Alerts Created
          type: integer
        alerts_deduplicated:
          title: Alerts Deduplicated
          type: integer
        artifact_id:
          title: Artifact Id
          type: string
      required:
      - artifact_id
      - alerts_created
      - alerts_deduplicated
      - alert_uuids
      title: CreateExternalAlertsResultDTO
      type: object
    DebugAcquireSettingsDTO:
      description: Lightweight acquire settings for debug (no encryption, no datagov).
      properties:
        auth:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          description: Dict with 'username' and 'password' keys.
          title: Auth
        body:
          anyOf:
          - {}
          - type: 'null'
          description: "Request body (dict/list \u2192 JSON, str \u2192 raw)."
          title: Body
        headers:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Headers
        inline_data:
          anyOf:
          - {}
          - type: 'null'
          description: "Skip HTTP \u2013 use this payload directly."
          title: Inline Data
        method:
          default: GET
          description: HTTP method.
          title: Method
          type: string
        query_params:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Query Params
        retries:
          default: 2
          title: Retries
          type: integer
        retry_delay:
          default: 1
          title: Retry Delay
          type: integer
        timeout:
          default: 30
          title: Timeout
          type: integer
        url:
          anyOf:
          - type: string
          - type: 'null'
          description: Target URL. Leave empty when using inline_data.
          title: Url
      title: DebugAcquireSettingsDTO
      type: object
    DebugEnrichInputDTO:
      properties:
        acquire_settings:
          $ref: '#/components/schemas/DebugAcquireSettingsDTO'
        extract_settings:
          $ref: '#/components/schemas/DebugExtractSettingsDTO'
      required:
      - acquire_settings
      - extract_settings
      title: DebugEnrichInputDTO
      type: object
    DebugEnrichResultDTO:
      properties:
        acquire:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Acquire
        count:
          title: Count
          type: integer
        entities:
          items: {}
          title: Entities
          type: array
        note:
          anyOf:
          - type: string
          - type: 'null'
          title: Note
        status:
          title: Status
          type: string
      required:
      - status
      - count
      - entities
      title: DebugEnrichResultDTO
      type: object
    DebugExtractSettingsDTO:
      properties:
        entity_mapping:
          items:
            $ref: '#/components/schemas/EntityMapping'
          title: Entity Mapping
          type: array
      required:
      - entity_mapping
      title: DebugExtractSettingsDTO
      type: object
    DebugLiquidResultDTO:
      properties:
        count:
          title: Count
          type: integer
        entities:
          items: {}
          title: Entities
          type: array
        note:
          anyOf:
          - type: string
          - type: 'null'
          title: Note
        status:
          title: Status
          type: string
      required:
      - status
      - count
      - entities
      title: DebugLiquidResultDTO
      type: object
    DebugSeederEraseRequestDTO:
      properties:
        team_id:
          title: Team Id
          type: string
      required:
      - team_id
      title: DebugSeederEraseRequestDTO
      type: object
    DebugSeederEraseResponseDTO:
      properties:
        access_policies_deleted:
          title: Access Policies Deleted
          type: integer
        artifacts_deleted:
          title: Artifacts Deleted
          type: integer
        edges_deleted:
          title: Edges Deleted
          type: integer
        finished_at:
          title: Finished At
          type: string
        hosts_deleted:
          title: Hosts Deleted
          type: integer
        kb_documents_deleted:
          title: Kb Documents Deleted
          type: integer
        materializations_deleted:
          title: Materializations Deleted
          type: integer
        mentions_deleted:
          title: Mentions Deleted
          type: integer
        mode:
          title: Mode
          type: string
        nodes_deleted:
          title: Nodes Deleted
          type: integer
        tasks_deleted:
          title: Tasks Deleted
          type: integer
        team_id:
          title: Team Id
          type: string
        workflows_deleted:
          title: Workflows Deleted
          type: integer
        workspaces_deleted:
          title: Workspaces Deleted
          type: integer
      required:
      - mode
      - team_id
      - edges_deleted
      - nodes_deleted
      - hosts_deleted
      - workspaces_deleted
      - kb_documents_deleted
      - mentions_deleted
      - materializations_deleted
      - artifacts_deleted
      - workflows_deleted
      - tasks_deleted
      - access_policies_deleted
      - finished_at
      title: DebugSeederEraseResponseDTO
      type: object
    DebugSeederGenerateRequestDTO:
      properties:
        nodes_per_root:
          default: 10
          maximum: 10.0
          minimum: 2.0
          title: Nodes Per Root
          type: integer
        num_roots:
          default: 5
          maximum: 5.0
          minimum: 1.0
          title: Num Roots
          type: integer
        num_workspaces:
          default: 2
          maximum: 5.0
          minimum: 1.0
          title: Num Workspaces
          type: integer
        overlap_chance:
          default: 0.2
          maximum: 1.0
          minimum: 0.0
          title: Overlap Chance
          type: number
        team_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Team Id
      title: DebugSeederGenerateRequestDTO
      type: object
    DebugSeederGenerateResponseDTO:
      properties:
        artifact_ids:
          items:
            type: string
          title: Artifact Ids
          type: array
        email_entities:
          additionalProperties:
            type: string
          title: Email Entities
          type: object
        extra_artifact_ids:
          items:
            type: string
          title: Extra Artifact Ids
          type: array
        overlap_stats:
          additionalProperties: true
          title: Overlap Stats
          type: object
        producer_workflow_id:
          title: Producer Workflow Id
          type: string
        root_uuids:
          items:
            type: string
          title: Root Uuids
          type: array
        task_artifact_ids:
          items:
            type: string
          title: Task Artifact Ids
          type: array
        task_ids:
          items:
            type: string
          title: Task Ids
          type: array
        task_tokens:
          items:
            type: string
          title: Task Tokens
          type: array
        team_id:
          title: Team Id
          type: string
        total_edges:
          title: Total Edges
          type: integer
        total_mentions:
          title: Total Mentions
          type: integer
        total_nodes:
          title: Total Nodes
          type: integer
        workflow_artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Artifact Id
        workflow_id:
          title: Workflow Id
          type: string
        workspace_ids:
          items:
            type: string
          title: Workspace Ids
          type: array
      required:
      - producer_workflow_id
      - workflow_id
      - team_id
      - task_ids
      - task_tokens
      - workspace_ids
      - root_uuids
      - artifact_ids
      - extra_artifact_ids
      - task_artifact_ids
      - workflow_artifact_id
      - email_entities
      - total_nodes
      - total_edges
      - total_mentions
      - overlap_stats
      title: DebugSeederGenerateResponseDTO
      type: object
    DeleteAllAlertsResultDTO:
      properties:
        deleted:
          title: Deleted
          type: integer
      required:
      - deleted
      title: DeleteAllAlertsResultDTO
      type: object
    DeleteAllEventsResultDTO:
      properties:
        deleted:
          title: Deleted
          type: integer
      required:
      - deleted
      title: DeleteAllEventsResultDTO
      type: object
    DeleteAllFeaturesResponse:
      properties:
        deleted:
          title: Deleted
          type: integer
      required:
      - deleted
      title: DeleteAllFeaturesResponse
      type: object
    DeleteAllIdentitiesResultDTO:
      properties:
        deleted:
          title: Deleted
          type: integer
      required:
      - deleted
      title: DeleteAllIdentitiesResultDTO
      type: object
    DeleteIdentityResultDTO:
      properties:
        deleted:
          title: Deleted
          type: integer
      required:
      - deleted
      title: DeleteIdentityResultDTO
      type: object
    DocumentDeleteArgumentsDTO:
      description: Arguments for deleting a document from the Knowledge Base
      properties:
        document_id:
          title: Document Id
          type: string
      required:
      - document_id
      title: DocumentDeleteArgumentsDTO
      type: object
    DocumentIngestionTriggerResultDTO:
      description: Sync response for KB ingest trigger, includes server-generated
        document_id.
      properties:
        document_id:
          title: Document Id
          type: string
        execution_id:
          title: Execution Id
          type: string
        workflow_id:
          title: Workflow Id
          type: string
      required:
      - workflow_id
      - execution_id
      - document_id
      title: DocumentIngestionTriggerResultDTO
      type: object
    DocumentIngestionWorkflowArgumentsDTO:
      description: 'Single-document ingestion workflow arguments for chunker/ingester
        architecture.


        This workflow processes ONE document at a time:

        1. Document gets chunked into pieces

        2. Chunks get batch-processed by IngesterIterator (Map state)


        For multiple documents, trigger multiple workflow executions.'
      properties:
        chunk_settings:
          $ref: '#/components/schemas/ChunkSettings'
          description: Chunking configuration
        document:
          $ref: '#/components/schemas/DocumentInputDTO'
          description: Root document to ingest
      required:
      - document
      title: DocumentIngestionWorkflowArgumentsDTO
      type: object
    DocumentInputDTO:
      description: Document input with either content or S3 source
      properties:
        content:
          anyOf:
          - minLength: 1
            type: string
          - type: 'null'
          description: Document content as text
          title: Content
        metadata:
          $ref: '#/components/schemas/KnowledgeBaseMetadata'
          description: Document metadata following KB schema
        s3_source_key:
          anyOf:
          - minLength: 1
            type: string
          - type: 'null'
          description: S3 URI in format 's3://bucket/key'
          title: S3 Source Key
      required:
      - metadata
      title: DocumentInputDTO
      type: object
    DocumentReadArgumentsDTO:
      description: Arguments for reading a document from the Knowledge Base
      properties:
        document_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Document Id
        source_document_ref:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Document Ref
      title: DocumentReadArgumentsDTO
      type: object
    DocumentReadResult:
      description: Result of reading a document
      properties:
        content:
          anyOf:
          - type: string
          - type: 'null'
          title: Content
        document_id:
          title: Document Id
          type: string
        error_message:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Message
        matched_document_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Matched Document Ids
        metadata:
          anyOf:
          - $ref: '#/components/schemas/KnowledgeBaseMetadata'
          - type: 'null'
        success:
          default: true
          title: Success
          type: boolean
      required:
      - document_id
      title: DocumentReadResult
      type: object
    DocumentSearchArgumentsDTO:
      properties:
        limit:
          default: 10
          description: Maximum number of results to return (1-100)
          maximum: 100.0
          minimum: 1.0
          title: Limit
          type: integer
        metadata_filters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Metadata filters as dict (simple filter format)
          title: Metadata Filters
        query:
          description: Text query for semantic search
          maxLength: 1000
          minLength: 1
          title: Query
          type: string
        return_fields:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: Metadata properties to return from search results (e.g., ['mcp_json'])
          title: Return Fields
      required:
      - query
      title: DocumentSearchArgumentsDTO
      type: object
    DocumentSearchResult:
      description: Result of document search
      properties:
        query:
          title: Query
          type: string
        results:
          items:
            $ref: '#/components/schemas/SearchResultItem'
          title: Results
          type: array
        total_results:
          title: Total Results
          type: integer
      required:
      - query
      - results
      - total_results
      title: DocumentSearchResult
      type: object
    EmailNotificationSettings:
      description: Email channel settings with connection settings for SendmailExecutor.
      properties:
        bcc:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Bcc
        cc:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Cc
        channel_slug:
          const: email
          default: email
          title: Channel Slug
          type: string
        connection_settings:
          $ref: '#/components/schemas/SendmailExecutorInputDTO'
      required:
      - connection_settings
      title: EmailNotificationSettings
      type: object
    EncodingTypeEnum:
      description: Encoding types for materialized content.
      enum:
      - json
      - parquet
      - vector
      - text
      - protobuf
      title: EncodingTypeEnum
      type: string
    EnrichWorkflowInputArgs:
      properties:
        acquisition_args:
          $ref: '#/components/schemas/AcquisitionExecutorInputArgsDTO'
        extraction_settings:
          $ref: '#/components/schemas/EntityExtractionSettingsDTO'
        notification_targets:
          anyOf:
          - items:
              $ref: '#/components/schemas/NotificationTargets'
            type: array
          - type: 'null'
          description: Optional list of notification targets where notifications will
            be sent on workflow completion
          title: Notification Targets
        origin_source:
          anyOf:
          - $ref: '#/components/schemas/OriginSourceDescriptor'
          - type: 'null'
          description: Optional origin source metadata for notifications
        persistence_settings:
          $ref: '#/components/schemas/PersistGraphExecutorSettingsDTO'
      required:
      - acquisition_args
      - extraction_settings
      - persistence_settings
      title: EnrichWorkflowInputArgs
      type: object
    EntityExtractionSettingsDTO:
      properties:
        entity_mapping:
          items:
            $ref: '#/components/schemas/EntityMapping'
          title: Entity Mapping
          type: array
      required:
      - entity_mapping
      title: EntityExtractionSettingsDTO
      type: object
    EntityExtractionWorkflowArgumentsDTO:
      properties:
        document:
          $ref: '#/components/schemas/TransportDataModel_Any_'
        expected_entity_names:
          items:
            type: string
          title: Expected Entity Names
          type: array
        external_entity_mapping:
          items:
            $ref: '#/components/schemas/EntityMapping'
          title: External Entity Mapping
          type: array
        llm_settings:
          $ref: '#/components/schemas/LLMInvokerExecutorSettingsDTO'
          description: LLM configuration including provider, model, and API key
        notification_targets:
          anyOf:
          - items:
              $ref: '#/components/schemas/NotificationTargets'
            type: array
          - type: 'null'
          description: Optional list of notification targets where notifications will
            be sent on workflow completion
          title: Notification Targets
        origin_source:
          anyOf:
          - $ref: '#/components/schemas/OriginSourceDescriptor'
          - type: 'null'
          description: Optional origin source metadata for notifications
      required:
      - expected_entity_names
      - document
      - llm_settings
      title: EntityExtractionWorkflowArgumentsDTO
      type: object
    EntityMapping:
      properties:
        count:
          default: 0
          title: Count
          type: integer
        entity_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Id
        entity_name:
          title: Entity Name
          type: string
        liquidTemplate:
          anyOf:
          - type: string
          - type: 'null'
          title: Liquidtemplate
        liquidTemplateOutputType:
          $ref: '#/components/schemas/LiquidTemplateOutputTypesEnum'
        mapping_group_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Mapping Group Slug
        pass_through:
          anyOf:
          - type: boolean
          - type: 'null'
          default: false
          title: Pass Through
        skip_if_empty:
          default: true
          title: Skip If Empty
          type: boolean
        verified:
          default: false
          title: Verified
          type: boolean
      required:
      - entity_name
      - liquidTemplateOutputType
      title: EntityMapping
      type: object
    EvaluatorInfoDTO:
      properties:
        description:
          title: Description
          type: string
        name:
          title: Name
          type: string
      required:
      - name
      - description
      title: EvaluatorInfoDTO
      type: object
    EvaluatorSettingsItem:
      description: Settings for a single evaluator within the pipeline.
      properties:
        dedup_period_mins:
          default: 60
          title: Dedup Period Mins
          type: integer
        evaluation_parameters:
          additionalProperties: true
          default: {}
          title: Evaluation Parameters
          type: object
        name:
          title: Name
          type: string
      required:
      - name
      title: EvaluatorSettingsItem
      type: object
    ExternalAlertItemDTO:
      description: "REST write DTO for external alert ingestion.\n\nInherits all caller-supplied\
        \ fields from SecurityAlertWriteFields.\nOverrides that differ from the base:\n\
        - origin_hash: required str (narrowed from optional str|list|None).\n  Identifies\
        \ the external source system (e.g. 'crowdstrike', 'splunk').\n  Used as the\
        \ governing Artifact's origin and as the source-system index key.\n- dedup_key:\
        \ optional str (inherits default \"\"), but must be non-empty when\n  explicitly\
        \ provided (min_length=1 is not applied to the default by Pydantic)."
      properties:
        alert_context:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Alert Context
        dedup_key:
          default: ''
          minLength: 1
          title: Dedup Key
          type: string
        description:
          default: ''
          title: Description
          type: string
        evaluator_name:
          default: _external
          title: Evaluator Name
          type: string
        log_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Log Type
        origin_hash:
          description: Source-system identifier (e.g. 'crowdstrike', 'splunk'). Required
            for external ingestion. Used as the governing Artifact's origin and as
            the alert source-system index.
          title: Origin Hash
          type: string
        payload:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Payload
        reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Reason
        rule_id:
          default: ''
          title: Rule Id
          type: string
        severity:
          default: info
          title: Severity
          type: string
        tags:
          default: []
          items:
            type: string
          title: Tags
          type: array
        title:
          default: ''
          title: Title
          type: string
      required:
      - origin_hash
      title: ExternalAlertItemDTO
      type: object
    ExternalCallbackInputDTO:
      properties:
        callback_type:
          $ref: '#/components/schemas/ExternalCallbackTypesEnum'
        correlation_id:
          title: Correlation Id
          type: string
        payload:
          anyOf:
          - additionalProperties: true
            type: object
          - type: string
          - type: integer
          title: Payload
      required:
      - callback_type
      - correlation_id
      - payload
      title: ExternalCallbackInputDTO
      type: object
    ExternalCallbackResultDTO:
      properties:
        success:
          title: Success
          type: boolean
      required:
      - success
      title: ExternalCallbackResultDTO
      type: object
    ExternalCallbackTypesEnum:
      enum:
      - success
      - failure
      - status
      - progress
      title: ExternalCallbackTypesEnum
      type: string
    FeatureItemResponse:
      properties:
        created_at:
          default: ''
          title: Created At
          type: string
        dedup_key:
          title: Dedup Key
          type: string
        payload:
          additionalProperties: true
          default: {}
          title: Payload
          type: object
        slug:
          title: Slug
          type: string
        team_id:
          title: Team Id
          type: string
        ttl:
          anyOf:
          - type: integer
          - type: 'null'
          title: Ttl
        unique_user_identifier:
          anyOf:
          - type: string
          - type: 'null'
          title: Unique User Identifier
        updated_ts:
          default: ''
          title: Updated Ts
          type: string
      required:
      - slug
      - team_id
      - dedup_key
      title: FeatureItemResponse
      type: object
    FeatureLookupArgumentsDTO:
      properties:
        after_timestamp:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO-8601 lower bound on created_at for temporal features.
          title: After Timestamp
        before_timestamp:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO-8601 upper bound on created_at for temporal features.
          title: Before Timestamp
        limit:
          default: 20
          description: Max temporal-bucket rows per slug.
          maximum: 100.0
          minimum: 1.0
          title: Limit
          type: integer
        slugs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: Feature slugs to return. Omit to return every registered slug.
          title: Slugs
        unique_user_identifier:
          description: Unique user identifier (e.g. email) to look up features for.
          minLength: 1
          title: Unique User Identifier
          type: string
      required:
      - unique_user_identifier
      title: FeatureLookupArgumentsDTO
      type: object
    FxSettingsItem:
      description: Runtime settings for a single feature extractor in the pipeline.
      properties:
        extraction_parameters:
          additionalProperties: true
          default: {}
          title: Extraction Parameters
          type: object
        name:
          title: Name
          type: string
      required:
      - name
      title: FxSettingsItem
      type: object
    GraphCreateEdgeDTO:
      additionalProperties: false
      properties:
        created_at:
          format: date-time
          title: Created At
          type: string
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
          default: edge
        existing_artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Existing Artifact Id
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
          default: data
        pending:
          default: false
          title: Pending
          type: boolean
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        source_uuid:
          title: Source Uuid
          type: string
        target_uuid:
          title: Target Uuid
          type: string
        uuid:
          anyOf:
          - type: string
          - type: 'null'
          title: Uuid
      required:
      - label
      - source_uuid
      - target_uuid
      title: GraphCreateEdgeDTO
      type: object
    GraphCreateNodeDTO:
      additionalProperties: false
      properties:
        created_at:
          format: date-time
          title: Created At
          type: string
        entity_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Id
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
          default: node
        existing_artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Existing Artifact Id
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
          default: data
        pending:
          default: false
          title: Pending
          type: boolean
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        uuid:
          anyOf:
          - type: string
          - type: 'null'
          title: Uuid
      required:
      - label
      title: GraphCreateNodeDTO
      type: object
    GraphDeleteEntitiesResultDTO:
      properties:
        deleted_edges:
          default: 0
          title: Deleted Edges
          type: integer
        deleted_hosts:
          default: 0
          title: Deleted Hosts
          type: integer
        deleted_nodes:
          default: 0
          title: Deleted Nodes
          type: integer
      title: GraphDeleteEntitiesResultDTO
      type: object
    GraphEdgeDataEntity:
      description: "Edge entity connecting two nodes within a single workspace/host.\n\
        \nInvariant:\n- `workspace_id` MUST contain exactly one host identifier.\n\
        - Edges are never multi-host; cross-workspace semantics must be modeled\n\
        \  via nodes (multi-host membership) and/or edges that live in a dedicated\n\
        \  analysis/meta workspace."
      properties:
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          format: date-time
          title: Created At
          type: string
        custom_attributes:
          additionalProperties: true
          description: Custom, dynamic properties to store arbitrary data
          title: Custom Attributes
          type: object
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
        id:
          anyOf:
          - type: number
          - type: string
          - type: integer
          - type: 'null'
          title: Id
        initial_creator_user_id:
          title: Initial Creator User Id
          type: string
        internal_source_uuid:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: Internal Source Uuid
        internal_target_uuid:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: Internal Target Uuid
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
        mention_ids:
          items:
            type: string
          title: Mention Ids
          type: array
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        pending:
          default: false
          title: Pending
          type: boolean
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        source_uuid:
          title: Source Uuid
          type: string
        target_uuid:
          title: Target Uuid
          type: string
        uuid:
          title: Uuid
          type: string
        workspace_ids:
          items:
            type: string
          title: Workspace Ids
          type: array
      required:
      - resource_refs
      - initial_creator_user_id
      - label
      - source_uuid
      - target_uuid
      title: GraphEdgeDataEntity
      type: object
    GraphEdgeQueryInputDTO:
      properties:
        allow_orphan_edges:
          default: false
          description: By default we only return edges that have nodes loaded
          title: Allow Orphan Edges
          type: boolean
        fields_to_return:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Fields To Return
        filters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Properties to filter nodes or edges.
          title: Filters
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of initiated session IDs to filter nodes
          title: Initiated Session Ids
        limit:
          anyOf:
          - type: integer
          - type: 'null'
          description: Maximum number of nodes to return
          title: Limit
        mention_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Mention IDs to filter nodes or edges.
          title: Mention Ids
        offset:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          description: Number of nodes to skip for pagination
          title: Offset
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Producer Actor IDs to filter nodes or edges.
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Producer Task IDs to filter nodes or edges.
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Producer Workflow IDs to filter nodes or edges.
          title: Producer Workflow Ids
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Session group ID to filter nodes or edges.
          title: Session Group Id
        source_uuid:
          anyOf:
          - type: string
          - type: 'null'
          description: UUID of the source node for edge queries.
          title: Source Uuid
        target_uuid:
          anyOf:
          - type: string
          - type: 'null'
          description: UUID of the target node for edge queries.
          title: Target Uuid
        uuid:
          anyOf:
          - type: string
          - type: 'null'
          description: UUID of the query, shortcut
          title: Uuid
        workspace_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Workspace IDs to filter nodes or edges by workspace
            membership.
          title: Workspace Ids
      title: GraphEdgeQueryInputDTO
      type: object
    GraphEdgeReturnDTO:
      properties:
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          format: date-time
          title: Created At
          type: string
        custom_attributes:
          additionalProperties: true
          description: Custom, dynamic properties to store arbitrary data
          title: Custom Attributes
          type: object
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
        id:
          anyOf:
          - type: number
          - type: string
          - type: integer
          - type: 'null'
          title: Id
        initial_creator_user_id:
          title: Initial Creator User Id
          type: string
        internal_source_uuid:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: Internal Source Uuid
        internal_target_uuid:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: Internal Target Uuid
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
        mention_ids:
          items:
            type: string
          title: Mention Ids
          type: array
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        pending:
          default: false
          title: Pending
          type: boolean
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        source_uuid:
          title: Source Uuid
          type: string
        target_uuid:
          title: Target Uuid
          type: string
        uuid:
          title: Uuid
          type: string
        workspace_ids:
          items:
            type: string
          title: Workspace Ids
          type: array
      required:
      - resource_refs
      - initial_creator_user_id
      - label
      - uuid
      - source_uuid
      - target_uuid
      title: GraphEdgeReturnDTO
      type: object
    GraphEntityTypeSelectionScopeEnum:
      enum:
      - node
      - edge
      - combined
      - workspace
      - any
      title: GraphEntityTypeSelectionScopeEnum
      type: string
    GraphEntityTypesEnum:
      enum:
      - node
      - edge
      - workspace
      title: GraphEntityTypesEnum
      type: string
    GraphInsightsCacheInvalidateResultDTO:
      description: Result DTO for cache invalidation operations
      properties:
        deleted_count:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of cached items deleted
          title: Deleted Count
        error:
          anyOf:
          - type: string
          - type: 'null'
          description: Error message if operation failed
          title: Error
        message:
          anyOf:
          - type: string
          - type: 'null'
          description: Success message
          title: Message
        success:
          description: Whether the cache invalidation was successful
          title: Success
          type: boolean
        workspace_id:
          description: Workspace ID for which cache was invalidated
          title: Workspace Id
          type: string
      required:
      - success
      - workspace_id
      title: GraphInsightsCacheInvalidateResultDTO
      type: object
    GraphInsightsInputDTO:
      properties:
        query:
          $ref: '#/components/schemas/GraphQueryInputDTO'
          description: Query parameters for graph insights
      required:
      - query
      title: GraphInsightsInputDTO
      type: object
    GraphInsightsResult:
      properties:
        count_edges:
          anyOf:
          - type: integer
          - type: 'null'
          title: Count Edges
        count_nodes:
          anyOf:
          - type: integer
          - type: 'null'
          title: Count Nodes
        items:
          $ref: '#/components/schemas/GraphTraverseItemsDTO'
          description: Compressed graph result with traversal DTOs.
        pagination:
          anyOf:
          - $ref: '#/components/schemas/PaginableResultMeta'
          - type: 'null'
      required:
      - items
      title: GraphInsightsResult
      type: object
    GraphLayerTypesEnum:
      enum:
      - graph
      - flow
      - data
      title: GraphLayerTypesEnum
      type: string
    GraphLookupSingleEntityArgs:
      properties:
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
        uuid:
          title: Uuid
          type: string
      required:
      - entity_type
      - uuid
      title: GraphLookupSingleEntityArgs
      type: object
    GraphNodeDataEntity:
      properties:
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          format: date-time
          title: Created At
          type: string
        custom_attributes:
          additionalProperties: true
          description: Custom, dynamic properties to store arbitrary data
          title: Custom Attributes
          type: object
        entity_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Id
        entity_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Name
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
        id:
          anyOf:
          - type: number
          - type: string
          - type: integer
          - type: 'null'
          title: Id
        initial_creator_user_id:
          title: Initial Creator User Id
          type: string
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Initiated Session Ids
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
        mention_ids:
          items:
            type: string
          title: Mention Ids
          type: array
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        pending:
          default: false
          title: Pending
          type: boolean
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        uuid:
          title: Uuid
          type: string
        workspace_ids:
          items:
            type: string
          title: Workspace Ids
          type: array
      required:
      - resource_refs
      - initial_creator_user_id
      - label
      title: GraphNodeDataEntity
      type: object
    GraphNodePosition:
      properties:
        x:
          title: X
          type: integer
        y:
          title: Y
          type: integer
      title: GraphNodePosition
      type: object
    GraphNodeQueryInputDTO:
      properties:
        allow_orphan_edges:
          default: false
          description: By default we only return edges that have nodes loaded
          title: Allow Orphan Edges
          type: boolean
        fields_to_return:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Fields To Return
        filters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Properties to filter nodes or edges.
          title: Filters
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of initiated session IDs to filter nodes
          title: Initiated Session Ids
        limit:
          anyOf:
          - type: integer
          - type: 'null'
          description: Maximum number of nodes to return
          title: Limit
        mention_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Mention IDs to filter nodes or edges.
          title: Mention Ids
        offset:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          description: Number of nodes to skip for pagination
          title: Offset
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Producer Actor IDs to filter nodes or edges.
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Producer Task IDs to filter nodes or edges.
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Producer Workflow IDs to filter nodes or edges.
          title: Producer Workflow Ids
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Session group ID to filter nodes or edges.
          title: Session Group Id
        uuid:
          anyOf:
          - type: string
          - type: 'null'
          description: UUID of the query, shortcut
          title: Uuid
        workspace_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of Workspace IDs to filter nodes or edges by workspace
            membership.
          title: Workspace Ids
      title: GraphNodeQueryInputDTO
      type: object
    GraphNodeReturnDTO:
      properties:
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          format: date-time
          title: Created At
          type: string
        custom_attributes:
          additionalProperties: true
          description: Custom, dynamic properties to store arbitrary data
          title: Custom Attributes
          type: object
        entity_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Id
        entity_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Name
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
        id:
          anyOf:
          - type: number
          - type: string
          - type: integer
          - type: 'null'
          title: Id
        initial_creator_user_id:
          title: Initial Creator User Id
          type: string
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Initiated Session Ids
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
        mention_ids:
          items:
            type: string
          title: Mention Ids
          type: array
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        pending:
          default: false
          title: Pending
          type: boolean
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        uuid:
          title: Uuid
          type: string
        workspace_ids:
          items:
            type: string
          title: Workspace Ids
          type: array
      required:
      - resource_refs
      - initial_creator_user_id
      - label
      - uuid
      title: GraphNodeReturnDTO
      type: object
    GraphQueryInputDTO:
      properties:
        allow_orphan_edges:
          default: false
          description: By default we only return edges that have nodes loaded
          title: Allow Orphan Edges
          type: boolean
        edge_query:
          anyOf:
          - $ref: '#/components/schemas/GraphEdgeQueryInputDTO'
          - type: 'null'
        entity_selection_scope:
          $ref: '#/components/schemas/GraphEntityTypeSelectionScopeEnum'
          default: combined
          description: Entity type that will be queried (node, edge, or both)
        node_query:
          anyOf:
          - $ref: '#/components/schemas/GraphNodeQueryInputDTO'
          - type: 'null'
        resolution_mode:
          $ref: '#/components/schemas/GraphResolutionModeEnum'
          default: fast
          description: 'fast (default): filter on the capped Neptune vertex arrays
            (lowest latency). complete: resolve membership via the authoritative DocumentDB
            artifact/mention chain (lossless, higher latency). Does not affect ABAC
            enforcement.'
        skip_pending:
          default: true
          description: By default we do not show pending items
          title: Skip Pending
          type: boolean
        uuid:
          anyOf:
          - items: {}
            type: array
          - type: string
          - type: 'null'
          description: UUIDs of the query. If specified, system will throw error if
            not found or no access is provided.
          title: Uuid
        workspace_id:
          anyOf:
          - items: {}
            type: array
          - type: string
          - type: 'null'
          description: IDs of the workspace(s) to query, will return results from
            within only a workspace scope.
          title: Workspace Id
      title: GraphQueryInputDTO
      type: object
    GraphQueryResult:
      properties:
        count_edges:
          anyOf:
          - type: integer
          - type: 'null'
          title: Count Edges
        count_nodes:
          anyOf:
          - type: integer
          - type: 'null'
          title: Count Nodes
        items:
          $ref: '#/components/schemas/GraphQueryResultItems'
          description: Query result containing nodes and edges.
        pagination:
          anyOf:
          - $ref: '#/components/schemas/PaginableResultMeta'
          - type: 'null'
      required:
      - items
      title: GraphQueryResult
      type: object
    GraphQueryResultItems:
      properties:
        edges:
          anyOf:
          - items:
              $ref: '#/components/schemas/GraphEdgeDataEntity'
            type: array
          - type: 'null'
          default: []
          description: List of graph edges matching the query.
          title: Edges
        nodes:
          anyOf:
          - items:
              anyOf:
              - $ref: '#/components/schemas/GraphNodeDataEntity'
              - $ref: '#/components/schemas/GraphWorkspaceDataEntity'
            type: array
          - type: 'null'
          default: []
          description: List of graph nodes matching the query.
          title: Nodes
      title: GraphQueryResultItems
      type: object
    GraphResolutionModeEnum:
      description: "Resolution mode for queries that filter/group by bounded provenance\
        \ fields (ENG-1293).\n\n- FAST (default): filter/group on the capped Neptune\
        \ vertex producer_*_ids arrays\n  (bounded/recent, lowest latency). Does NOT\
        \ govern ABAC enforcement.\n- COMPLETE: resolve membership/lineage via the\
        \ authoritative DocumentDB artifact/mention\n  chain (lossless, higher latency).\
        \ Only fully correct after the historical mention\n  backfill has run."
      enum:
      - fast
      - complete
      title: GraphResolutionModeEnum
      type: string
    GraphTraverseEdgeDTO:
      description: Minimal edge data for agent (compact, essential fields only).
      properties:
        category:
          title: Category
          type: string
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        entity_properties:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Entity Properties
        source_uuid:
          title: Source Uuid
          type: string
        target_uuid:
          title: Target Uuid
          type: string
        uuid:
          title: Uuid
          type: string
      required:
      - uuid
      - category
      - source_uuid
      - target_uuid
      title: GraphTraverseEdgeDTO
      type: object
    GraphTraverseItemsDTO:
      description: Container for nodes and edges.
      properties:
        edges:
          items:
            $ref: '#/components/schemas/GraphTraverseEdgeDTO'
          title: Edges
          type: array
        nodes:
          items:
            $ref: '#/components/schemas/GraphTraverseNodeDTO'
          title: Nodes
          type: array
      required:
      - nodes
      - edges
      title: GraphTraverseItemsDTO
      type: object
    GraphTraverseNodeDTO:
      description: Minimal node data for agent (compact, essential fields only).
      properties:
        category:
          title: Category
          type: string
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        entity_properties:
          additionalProperties: true
          title: Entity Properties
          type: object
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Initiated Session Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        uuid:
          title: Uuid
          type: string
      required:
      - uuid
      - category
      - entity_properties
      title: GraphTraverseNodeDTO
      type: object
    GraphUpdateEdgeDTO:
      additionalProperties: false
      properties:
        entity_properties:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Initiated Session Ids
        label:
          anyOf:
          - type: string
          - type: 'null'
          description: The T.Label of the edge will be updated, this is a replace
            operation and can take significant amount of time to complete
          title: Label
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        set_fields:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Use to directly update fields with dot notation like __set:'foo.bar.baz.bak:999'
          title: Set Fields
      title: GraphUpdateEdgeDTO
      type: object
    GraphUpdateMultipleEntityInputDTO:
      properties:
        item:
          anyOf:
          - $ref: '#/components/schemas/GraphUpdateWorkspaceDTO'
          - $ref: '#/components/schemas/GraphUpdateEdgeDTO'
          - $ref: '#/components/schemas/GraphUpdateNodeDTO'
          title: Item
        query:
          $ref: '#/components/schemas/GraphQueryInputDTO'
      required:
      - query
      - item
      title: GraphUpdateMultipleEntityInputDTO
      type: object
    GraphUpdateMultipleEntityResultDTO:
      properties:
        updated_edges:
          title: Updated Edges
          type: integer
        updated_nodes:
          title: Updated Nodes
          type: integer
      required:
      - updated_nodes
      - updated_edges
      title: GraphUpdateMultipleEntityResultDTO
      type: object
    GraphUpdateNodeDTO:
      additionalProperties: false
      properties:
        entity_properties:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
        initiated_session_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Initiated Session Ids
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        set_fields:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Use to directly update fields with dot notation like __set:'foo.bar.baz.bak:999'
          title: Set Fields
      title: GraphUpdateNodeDTO
      type: object
    GraphUpdateSingleEntityInputDTO:
      properties:
        item:
          anyOf:
          - $ref: '#/components/schemas/GraphUpdateWorkspaceDTO'
          - $ref: '#/components/schemas/GraphUpdateEdgeDTO'
          - $ref: '#/components/schemas/GraphUpdateNodeDTO'
          title: Item
        query:
          $ref: '#/components/schemas/GraphLookupSingleEntityArgs'
      required:
      - query
      - item
      title: GraphUpdateSingleEntityInputDTO
      type: object
    GraphUpdateWorkspaceDTO:
      additionalProperties: false
      properties:
        entity_properties:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
        label:
          anyOf:
          - type: string
          - type: 'null'
          title: Label
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
      title: GraphUpdateWorkspaceDTO
      type: object
    GraphWorkspaceDataEntity:
      properties:
        created_at:
          format: date-time
          title: Created At
          type: string
        custom_attributes:
          additionalProperties: true
          description: Custom, dynamic properties to store arbitrary data
          title: Custom Attributes
          type: object
        entity_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Name
        entity_properties:
          additionalProperties: true
          description: Custom, dynamic properties of the custom entity
          title: Entity Properties
          type: object
        entity_type:
          $ref: '#/components/schemas/GraphEntityTypesEnum'
        id:
          anyOf:
          - type: number
          - type: string
          - type: integer
          - type: 'null'
          title: Id
        label:
          title: Label
          type: string
        layer:
          $ref: '#/components/schemas/GraphLayerTypesEnum'
        position:
          anyOf:
          - $ref: '#/components/schemas/GraphNodePosition'
          - type: 'null'
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        team_id:
          title: Team Id
          type: string
        user_id:
          title: User Id
          type: string
        uuid:
          title: Uuid
          type: string
      required:
      - team_id
      - resource_refs
      - label
      - user_id
      title: GraphWorkspaceDataEntity
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    HierarchicalSummarizeArgumentsDTO:
      description: Main input arguments for hierarchical summarization workflow
      properties:
        chunk_settings:
          $ref: '#/components/schemas/ChunkSettings'
          description: Chunking configuration for document breakdown
        compression_ratio:
          default: 0.5
          description: Compression ratio for hierarchical levels (0.5 = 50% retention,
            industry standard)
          maximum: 0.8
          minimum: 0.1
          title: Compression Ratio
          type: number
        document:
          $ref: '#/components/schemas/DocumentInputDTO'
          description: Document to be summarized (supports both inline content and
            S3 storage)
        llm_settings:
          $ref: '#/components/schemas/LLMInvokerExecutorSettingsDTO'
          description: LLM configuration for summarization
        size_unit:
          default: characters
          description: Size measurement unit (characters or tokens)
          title: Size Unit
          type: string
        target_size:
          description: Target size in characters for the final summary
          title: Target Size
          type: integer
      required:
      - document
      - target_size
      - llm_settings
      title: HierarchicalSummarizeArgumentsDTO
      type: object
    HierarchicalSummarizeWorkflowTriggerDTO:
      description: Trigger DTO for hierarchical summarization workflow
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/HierarchicalSummarizeArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: HierarchicalSummarizeWorkflowTriggerDTO
      type: object
    IdentityFeatureModel:
      description: 'A single identity feature record produced upstream (e.g. by a
        poller).


        The unique key is `(team_id, identity_key, identity_value)`. `user_id` is

        stored as an attribute. `created_ts` / `updated_ts` are filled in if the

        caller leaves them blank so producers can omit them.


        Governance lineage (artifact_id, resource_refs, producer_*_ids, etc.) comes

        from `GovernedDataEntity`.'
      properties:
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          default: ''
          title: Created At
          type: string
        created_ts:
          default: ''
          title: Created Ts
          type: string
        identity_key:
          title: Identity Key
          type: string
        identity_value:
          title: Identity Value
          type: string
        initial_creator_user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Initial Creator User Id
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Resource Refs
        score:
          default: 0.0
          title: Score
          type: number
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        team_id:
          title: Team Id
          type: string
        updated_ts:
          default: ''
          title: Updated Ts
          type: string
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
      required:
      - team_id
      - identity_key
      - identity_value
      title: IdentityFeatureModel
      type: object
    KnowledgeBaseDocumentCategoryEnum:
      description: Content categories for Knowledge Base documents - what kind of
        content
      enum:
      - tool-list
      - tool-item
      - user_content
      - agentic_summary
      - initial_input
      - invocation_result
      - workflow_internal
      title: KnowledgeBaseDocumentCategoryEnum
      type: string
    KnowledgeBaseMetadata:
      additionalProperties: true
      description: Metadata model for Knowledge Base documents
      properties:
        category:
          $ref: '#/components/schemas/KnowledgeBaseDocumentCategoryEnum'
        chunk_config_fingerprint:
          anyOf:
          - type: string
          - type: 'null'
          title: Chunk Config Fingerprint
        created_at:
          title: Created At
          type: string
        data_json:
          anyOf:
          - type: string
          - type: 'null'
          title: Data Json
        document_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Document Id
        group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Group Id
        producer_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
        producer_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
        resource_ref:
          anyOf:
          - type: string
          - type: 'null'
          title: Resource Ref
        s3_reference:
          anyOf:
          - type: string
          - type: 'null'
          title: S3 Reference
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        share_level:
          default: 0
          title: Share Level
          type: integer
        slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Slug
        source_document_id:
          title: Source Document Id
          type: string
        source_document_ref:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Document Ref
        success_status:
          anyOf:
          - type: string
          - type: 'null'
          title: Success Status
        tags:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tags
        team_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Team Id
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
        usage_type:
          $ref: '#/components/schemas/KnowledgeBaseUsageTypesEnum'
          default: internal
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
      required:
      - category
      title: KnowledgeBaseMetadata
      type: object
    KnowledgeBaseUsageTypesEnum:
      description: Usage type classification for documents
      enum:
      - internal
      - agent
      - any
      title: KnowledgeBaseUsageTypesEnum
      type: string
    LLMInvokerExecutorSettingsDTO:
      properties:
        context_window:
          default: 96000
          title: Context Window
          type: integer
        max_tokens:
          default: 2048
          title: Max Tokens
          type: integer
        model:
          title: Model
          type: string
        openai_api_key:
          anyOf:
          - type: string
          - type: 'null'
          title: Openai Api Key
        provider:
          $ref: '#/components/schemas/LLMProviderEnum'
        temperature:
          default: 0.7
          title: Temperature
          type: number
      required:
      - provider
      - model
      title: LLMInvokerExecutorSettingsDTO
      type: object
    LLMProviderEnum:
      enum:
      - openai
      title: LLMProviderEnum
      type: string
    LiquidExtractInputDTO:
      properties:
        content:
          title: Content
        entity_mapping:
          items:
            $ref: '#/components/schemas/EntityMapping'
          title: Entity Mapping
          type: array
      required:
      - content
      - entity_mapping
      title: LiquidExtractInputDTO
      type: object
    LiquidTemplateOutputTypesEnum:
      enum:
      - STRING
      - SCALAR
      - LIST
      - COLLECTION
      title: LiquidTemplateOutputTypesEnum
      type: string
    ListEvaluatorsResultDTO:
      properties:
        evaluators:
          items:
            $ref: '#/components/schemas/EvaluatorInfoDTO'
          title: Evaluators
          type: array
      required:
      - evaluators
      title: ListEvaluatorsResultDTO
      type: object
    LocalETLExecutorInputArgumentsDTO:
      properties:
        entity_mapping:
          items:
            $ref: '#/components/schemas/EntityMapping'
          title: Entity Mapping
          type: array
        node_uuid:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          title: Node Uuid
        persist_mapping:
          items:
            $ref: '#/components/schemas/PersistSettings'
          title: Persist Mapping
          type: array
        target_workspace_id:
          title: Target Workspace Id
          type: string
      required:
      - target_workspace_id
      - node_uuid
      - entity_mapping
      - persist_mapping
      title: LocalETLExecutorInputArgumentsDTO
      type: object
    MaterializationBulkCreateDTO:
      additionalProperties: false
      description: DTO for bulk creating Materializations.
      properties:
        materializations:
          items:
            $ref: '#/components/schemas/MaterializationCreateDTO'
          title: Materializations
          type: array
      required:
      - materializations
      title: MaterializationBulkCreateDTO
      type: object
    MaterializationCreateDTO:
      additionalProperties: false
      description: DTO for creating a new Materialization.
      properties:
        content_format:
          $ref: '#/components/schemas/ContentFormatEnum'
        content_scope:
          $ref: '#/components/schemas/ContentScopeEnum'
        encoding:
          anyOf:
          - $ref: '#/components/schemas/EncodingTypeEnum'
          - type: 'null'
        store_id:
          title: Store Id
          type: string
        subject_id:
          title: Subject Id
          type: string
        target_ref:
          title: Target Ref
          type: string
      required:
      - subject_id
      - store_id
      - content_scope
      - content_format
      - target_ref
      title: MaterializationCreateDTO
      type: object
    MaterializationResponseDTO:
      description: DTO for Materialization API responses.
      properties:
        content_format:
          $ref: '#/components/schemas/ContentFormatEnum'
        content_scope:
          $ref: '#/components/schemas/ContentScopeEnum'
        created_at:
          format: date-time
          title: Created At
          type: string
        encoding:
          anyOf:
          - $ref: '#/components/schemas/EncodingTypeEnum'
          - type: 'null'
        materialization_id:
          title: Materialization Id
          type: string
        state:
          $ref: '#/components/schemas/CommitStatesEnum'
        store_id:
          title: Store Id
          type: string
        subject_id:
          title: Subject Id
          type: string
        subject_type:
          default: artifact
          title: Subject Type
          type: string
        target_ref:
          title: Target Ref
          type: string
      required:
      - materialization_id
      - subject_id
      - store_id
      - content_scope
      - content_format
      - target_ref
      - state
      - created_at
      title: MaterializationResponseDTO
      type: object
    MentionBulkCreateDTO:
      additionalProperties: false
      description: DTO for bulk creating Mentions.
      properties:
        mentions:
          items:
            $ref: '#/components/schemas/MentionCreateDTO'
          title: Mentions
          type: array
      required:
      - mentions
      title: MentionBulkCreateDTO
      type: object
    MentionCreateDTO:
      additionalProperties: false
      description: DTO for creating a new Mention.
      properties:
        artifact_id:
          title: Artifact Id
          type: string
        confidence:
          anyOf:
          - maximum: 1.0
            minimum: 0.0
            type: number
          - type: 'null'
          title: Confidence
        entity_id:
          title: Entity Id
          type: string
        excerpt_span:
          anyOf:
          - type: string
          - type: 'null'
          title: Excerpt Span
        extractor:
          title: Extractor
          type: string
      required:
      - artifact_id
      - entity_id
      - extractor
      title: MentionCreateDTO
      type: object
    MentionResponseDTO:
      description: DTO for Mention API responses.
      properties:
        artifact_id:
          title: Artifact Id
          type: string
        confidence:
          anyOf:
          - type: number
          - type: 'null'
          title: Confidence
        created_at:
          format: date-time
          title: Created At
          type: string
        entity_id:
          title: Entity Id
          type: string
        excerpt_span:
          anyOf:
          - type: string
          - type: 'null'
          title: Excerpt Span
        extractor:
          title: Extractor
          type: string
        ingested_at:
          anyOf:
          - format: date-time
            type: string
          - type: 'null'
          title: Ingested At
        mention_id:
          title: Mention Id
          type: string
        state:
          $ref: '#/components/schemas/CommitStatesEnum'
      required:
      - mention_id
      - artifact_id
      - entity_id
      - extractor
      - state
      - created_at
      title: MentionResponseDTO
      type: object
    MiruSecDetectorLambdaSettings:
      description: "Lambda detector settings \u2014 scopes event queries by time window\
        \ and optionally by origin_hash."
      properties:
        cycle_interval_seconds:
          default: 60
          title: Cycle Interval Seconds
          type: integer
        evaluation_parameters:
          additionalProperties: true
          default: {}
          title: Evaluation Parameters
          type: object
        evaluators:
          anyOf:
          - items:
              $ref: '#/components/schemas/EvaluatorSettingsItem'
            type: array
          - $ref: '#/components/schemas/EvaluatorSettingsItem'
          default:
          - dedup_period_mins: 60
            evaluation_parameters: {}
            name: mirusec_suspicious_activity
          title: Evaluators
        max_cycles:
          default: 0
          title: Max Cycles
          type: integer
        max_internal_cycles_before_chaining:
          default: 500
          title: Max Internal Cycles Before Chaining
          type: integer
        origin_hash:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Origin Hash
        window_hours:
          default: 24
          title: Window Hours
          type: integer
      title: MiruSecDetectorLambdaSettings
      type: object
    MiruSecETLPollerSettings:
      description: MiruSec-specific poller settings.
      properties:
        cycle_interval_seconds:
          default: 60
          title: Cycle Interval Seconds
          type: integer
        fx_extractors:
          default: []
          items:
            $ref: '#/components/schemas/FxSettingsItem'
          title: Fx Extractors
          type: array
        identity_keys:
          default: []
          items:
            type: string
          title: Identity Keys
          type: array
        input_email:
          anyOf:
          - type: string
          - type: 'null'
          title: Input Email
        input_email_qualified_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Input Email Qualified Name
        input_since:
          anyOf:
          - type: string
          - type: 'null'
          title: Input Since
        input_since_qualified_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Input Since Qualified Name
        max_cycles:
          default: 0
          title: Max Cycles
          type: integer
        max_internal_cycles_before_chaining:
          default: 500
          title: Max Internal Cycles Before Chaining
          type: integer
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        stream_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Stream Type
        webhook_callback_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Webhook Callback Url
      title: MiruSecETLPollerSettings
      type: object
    NotificationChannelSlugEnum:
      enum:
      - slack
      - api
      - email
      - sns
      title: NotificationChannelSlugEnum
      type: string
    NotificationTargets:
      description: Descriptor for a notification.
      properties:
        channel_settings:
          discriminator:
            mapping:
              api: '#/components/schemas/APINotificationSettings'
              email: '#/components/schemas/EmailNotificationSettings'
              slack: '#/components/schemas/SlackNotificationSettings'
              sns: '#/components/schemas/SNSNotificationSettings'
            propertyName: channel_slug
          oneOf:
          - $ref: '#/components/schemas/SlackNotificationSettings'
          - $ref: '#/components/schemas/APINotificationSettings'
          - $ref: '#/components/schemas/EmailNotificationSettings'
          - $ref: '#/components/schemas/SNSNotificationSettings'
          title: Channel Settings
        channel_slug:
          $ref: '#/components/schemas/NotificationChannelSlugEnum'
        process_stage:
          anyOf:
          - type: string
          - type: 'null'
          description: When specified, the system will only emit this notification
            if the trigger slug criteria is met, this will be implemented at a later
            time, when we'll need to emit different notifications at different stages
            of a given process
          title: Process Stage
        send_only_full_json_body:
          default: false
          description: When true, send only the full_json_body dict as the notification
            payload instead of the full NotificationMessage. Requires full_json_body
            to be non-empty.
          title: Send Only Full Json Body
          type: boolean
      required:
      - channel_slug
      - channel_settings
      title: NotificationTargets
      type: object
    OriginSourceDescriptor:
      description: Describes the origin source for notifications.
      properties:
        description:
          anyOf:
          - type: string
          - type: 'null'
          description: Description of the origin source
          title: Description
        nice_name:
          anyOf:
          - type: string
          - type: 'null'
          description: Human-readable name for the origin source
          title: Nice Name
        source_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Unique identifier for the origin source (e.g., alertsource
            ID)
          title: Source Id
        source_link:
          anyOf:
          - type: string
          - type: 'null'
          description: Primary link to the origin source (e.g., link to the alert)
          title: Source Link
        source_settings_link:
          anyOf:
          - type: string
          - type: 'null'
          description: Link to the origin source settings (e.g., alert settings page)
          title: Source Settings Link
      title: OriginSourceDescriptor
      type: object
    OrphanEntryTypesEnum:
      description: 'Entry types that can become orphaned (missing parent artifact).

        Used by find_or_clean_orphan_entries for cleanup operations.'
      enum:
      - mention
      - materialization
      title: OrphanEntryTypesEnum
      type: string
    PaginableResultMeta:
      properties:
        count:
          title: Count
          type: integer
      required:
      - count
      title: PaginableResultMeta
      type: object
    PayloadTypesEnum:
      enum:
      - FULL
      - SAMPLE
      title: PayloadTypesEnum
      type: string
    PersistGraphExecutorSettingsDTO:
      properties:
        persist_settings:
          items:
            $ref: '#/components/schemas/PersistSettings'
          title: Persist Settings
          type: array
      required:
      - persist_settings
      title: PersistGraphExecutorSettingsDTO
      type: object
    PersistSettings:
      additionalProperties: true
      properties:
        mapping_group_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Mapping Group Slug
        node_deduplication_fields:
          items:
            type: string
          title: Node Deduplication Fields
          type: array
        relationship:
          anyOf:
          - type: string
          - type: 'null'
          title: Relationship
        source_entity_selection_expression:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Source Entity Selection Expression
        target_workspace_id:
          title: Target Workspace Id
          type: string
      required:
      - target_workspace_id
      title: PersistSettings
      type: object
    QueryAlertsResultDTO:
      properties:
        has_more:
          title: Has More
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/SecurityAlert'
          title: Items
          type: array
        next_cursor:
          anyOf:
          - type: string
          - type: 'null'
          title: Next Cursor
      required:
      - items
      - next_cursor
      - has_more
      title: QueryAlertsResultDTO
      type: object
    QueryEventsResultDTO:
      properties:
        has_more:
          title: Has More
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/SecurityEvent'
          title: Items
          type: array
        next_cursor:
          anyOf:
          - type: string
          - type: 'null'
          title: Next Cursor
      required:
      - items
      - next_cursor
      - has_more
      title: QueryEventsResultDTO
      type: object
    QueryFeaturesResponse:
      properties:
        has_more:
          default: false
          title: Has More
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/FeatureItemResponse'
          title: Items
          type: array
        next_cursor:
          anyOf:
          - type: string
          - type: 'null'
          title: Next Cursor
      required:
      - items
      title: QueryFeaturesResponse
      type: object
    QueryIdentitiesResultDTO:
      properties:
        has_more:
          title: Has More
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/IdentityFeatureModel'
          title: Items
          type: array
        next_cursor:
          anyOf:
          - type: string
          - type: 'null'
          title: Next Cursor
      required:
      - items
      - next_cursor
      - has_more
      title: QueryIdentitiesResultDTO
      type: object
    QueryMultiSlugResponse:
      properties:
        features:
          additionalProperties:
            anyOf:
            - $ref: '#/components/schemas/ConsolidatedFeatureResponse'
            - $ref: '#/components/schemas/TemporalFeatureResponse'
          title: Features
          type: object
      required:
      - features
      title: QueryMultiSlugResponse
      type: object
    RefreshTokenRequest:
      description: Request body for token refresh endpoint.
      properties:
        refresh_token:
          description: Cognito refresh token to exchange for new tokens
          title: Refresh Token
          type: string
      required:
      - refresh_token
      title: RefreshTokenRequest
      type: object
    RefreshTokenResponse:
      description: Response from token refresh endpoint.
      properties:
        access_token:
          description: New Cognito access token
          title: Access Token
          type: string
        auth_token:
          description: 'Token to send as Bearer for API calls. Server picks the env-appropriate
            one: AccessToken on AWS (Pre-Token-Generation Lambda hydrates teamId/teamRole),
            IdToken on LocalStack (stock Cognito only puts custom:* claims in IdToken).'
          title: Auth Token
          type: string
        expires_in:
          description: Token validity in seconds (typically 3600)
          title: Expires In
          type: integer
        id_token:
          description: New Cognito ID token (contains custom claims)
          title: Id Token
          type: string
      required:
      - id_token
      - access_token
      - auth_token
      - expires_in
      title: RefreshTokenResponse
      type: object
    ResolvePoliciesRequestDTO:
      description: Request body for the resolve-policies debugging endpoint.
      properties:
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        resource_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Resource Type
      required:
      - resource_refs
      title: ResolvePoliciesRequestDTO
      type: object
    SNSNotificationSettings:
      description: SNS channel settings for AWS SNS topic publishing.
      properties:
        channel_slug:
          const: sns
          default: sns
          title: Channel Slug
          type: string
        message_attributes:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Message Attributes
        subject:
          anyOf:
          - type: string
          - type: 'null'
          title: Subject
        topic_arn:
          title: Topic Arn
          type: string
      required:
      - topic_arn
      title: SNSNotificationSettings
      type: object
    SearchResultItem:
      description: Individual search result item
      properties:
        chunk_content:
          title: Chunk Content
          type: string
        document_id:
          title: Document Id
          type: string
        document_metadata:
          $ref: '#/components/schemas/KnowledgeBaseMetadata'
        similarity_score:
          title: Similarity Score
          type: number
      required:
      - document_id
      - chunk_content
      - document_metadata
      - similarity_score
      title: SearchResultItem
      type: object
    SecurityAlert:
      description: 'Read model for security alerts.


        Governance lineage (team_id, artifact_id, resource_refs, producer_*_ids,

        initial_creator_user_id, session_group_id) comes from GovernedDataEntity.

        Caller-supplied alert fields come from SecurityAlertWriteFields.'
      properties:
        alert_context:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Alert Context
        alert_notification_sent:
          default: false
          title: Alert Notification Sent
          type: boolean
        alert_uuid:
          title: Alert Uuid
          type: string
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          title: Created At
          type: string
        dedup_key:
          default: ''
          title: Dedup Key
          type: string
        description:
          default: ''
          title: Description
          type: string
        evaluation_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Evaluation Hash
        evaluator_name:
          default: _external
          title: Evaluator Name
          type: string
        initial_creator_user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Initial Creator User Id
        log_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Log Type
        notification_attempt_count:
          default: 0
          title: Notification Attempt Count
          type: integer
        notification_dead:
          default: false
          title: Notification Dead
          type: boolean
        origin_hash:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          - type: 'null'
          title: Origin Hash
        payload:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Payload
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Reason
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Resource Refs
        rule_id:
          default: ''
          title: Rule Id
          type: string
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        severity:
          default: info
          title: Severity
          type: string
        tags:
          default: []
          items:
            type: string
          title: Tags
          type: array
        team_id:
          title: Team Id
          type: string
        title:
          default: ''
          title: Title
          type: string
      required:
      - team_id
      - created_at
      - alert_uuid
      title: SecurityAlert
      type: object
    SecurityEvent:
      properties:
        artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
        created_at:
          default: ''
          title: Created At
          type: string
        event_category:
          title: Event Category
          type: string
        event_id:
          title: Event Id
          type: string
        event_timestamp:
          title: Event Timestamp
          type: string
        event_type:
          title: Event Type
          type: string
        event_uuid:
          title: Event Uuid
          type: string
        initial_creator_user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Initial Creator User Id
        origin_hash:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin Hash
        outcome:
          title: Outcome
          type: string
        payload:
          additionalProperties: true
          default: {}
          title: Payload
          type: object
        producer_actor_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Actor Ids
        producer_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Task Ids
        producer_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
        producer_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Producer Workflow Ids
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Resource Refs
        root_entity_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Entity Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        stream_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Stream Type
        team_id:
          title: Team Id
          type: string
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
      required:
      - team_id
      - event_id
      - event_type
      - event_category
      - outcome
      - event_timestamp
      title: SecurityEvent
      type: object
    SecurityEventQueryArgumentsDTO:
      properties:
        after_timestamp:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO-8601 lower bound on the event SK (sort key, timestamp-derived).
          title: After Timestamp
        before_timestamp:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO-8601 upper bound on the event SK (sort key, timestamp-derived).
          title: Before Timestamp
        cursor:
          anyOf:
          - type: string
          - type: 'null'
          description: Opaque pagination cursor returned by a previous call.
          title: Cursor
        event_uuid:
          anyOf:
          - type: string
          - type: 'null'
          description: If provided, performs a point lookup of a single event by its
            event_uuid and ignores every other filter. Use this when you already know
            the event id.
          title: Event Uuid
        limit:
          default: 20
          description: Maximum number of events to return per page.
          maximum: 100.0
          minimum: 1.0
          title: Limit
          type: integer
        origin_hash:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          - type: 'null'
          description: Filter events by origin_hash. Pass a single string to use the
            origin-indexed query path; pass a list to filter the base-table query.
            Omit to skip.
          title: Origin Hash
        producer_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter events by the producing workflow / session anchor. Combined
            with a single origin_hash this hits the origin+session index.
          title: Producer Workflow Id
      title: SecurityEventQueryArgumentsDTO
      type: object
    SemanticWorkflowDTO:
      properties:
        flattened_child_task_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Flattened Child Task Ids
        flattened_child_workflow_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Flattened Child Workflow Ids
        tasks:
          items:
            $ref: '#/components/schemas/SimplifiedTaskDTO'
          title: Tasks
          type: array
        workflow:
          $ref: '#/components/schemas/SimplifiedWorkflowDTO'
      required:
      - workflow
      - tasks
      title: SemanticWorkflowDTO
      type: object
    SendmailExecutorInputDTO:
      properties:
        email:
          description: Recipient email address.
          title: Email
          type: string
        headers:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional JSON string of additional email headers.
          title: Headers
        sender:
          anyOf:
          - type: string
          - type: 'null'
          description: Sender email address. If not provided, defaults to SMTP user.
          title: Sender
        smtp_host:
          anyOf:
          - type: string
          - type: 'null'
          description: SMTP server hostname or IP address.
          title: Smtp Host
        smtp_password:
          anyOf:
          - type: string
          - type: 'null'
          description: SMTP password for authentication.
          title: Smtp Password
        smtp_port:
          anyOf:
          - type: string
          - type: integer
          - type: 'null'
          description: SMTP server port number.
          title: Smtp Port
        smtp_user:
          anyOf:
          - type: string
          - type: 'null'
          description: SMTP username for authentication.
          title: Smtp User
        subject:
          description: Subject of the email message.
          title: Subject
          type: string
        text:
          description: Plain text content of the email message.
          title: Text
          type: string
      required:
      - subject
      - email
      - text
      - smtp_host
      - smtp_port
      - smtp_user
      - smtp_password
      - sender
      title: SendmailExecutorInputDTO
      type: object
    SimplifiedTaskDTO:
      properties:
        children:
          items: {}
          title: Children
          type: array
        error:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Error
        input_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Input Payload
        parent_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Task Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Result Payload
        startDate:
          anyOf:
          - format: date-time
            type: string
          - type: 'null'
          title: Startdate
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        stopDate:
          anyOf:
          - format: date-time
            type: string
          - type: 'null'
          title: Stopdate
        task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Id
        task_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Name
        task_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Slug
        update_ts:
          anyOf:
          - type: integer
          - type: 'null'
          title: Update Ts
        workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Id
      title: SimplifiedTaskDTO
      type: object
    SimplifiedWorkflowDTO:
      properties:
        child_workflows:
          anyOf:
          - items:
              $ref: '#/components/schemas/SimplifiedWorkflowDTO'
            type: array
          - type: 'null'
          title: Child Workflows
        current_task_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Current Task Name
        current_task_status:
          anyOf:
          - $ref: '#/components/schemas/WorkflowStatusEnum'
          - type: string
          - type: 'null'
          title: Current Task Status
        current_task_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Current Task Type
        duration_ms:
          anyOf:
          - type: integer
          - type: 'null'
          title: Duration Ms
        error:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Error
        execution_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Execution Id
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        parent_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Task Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        startDate:
          format: date-time
          title: Startdate
          type: string
        state_machine_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: State Machine Slug
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        stopDate:
          anyOf:
          - format: date-time
            type: string
          - type: 'null'
          title: Stopdate
        update_ts:
          anyOf:
          - type: integer
          - type: 'null'
          title: Update Ts
        workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Id
      required:
      - startDate
      title: SimplifiedWorkflowDTO
      type: object
    SlackNotificationSettings:
      description: Slack channel settings with connection settings for AcquisitionExecutor.
      properties:
        channel:
          anyOf:
          - type: string
          - type: 'null'
          title: Channel
        channel_slug:
          const: slack
          default: slack
          title: Channel Slug
          type: string
        connection_settings:
          $ref: '#/components/schemas/AcquisitionExecutorInputArgsDTO'
        icon_emoji:
          anyOf:
          - type: string
          - type: 'null'
          title: Icon Emoji
        username:
          anyOf:
          - type: string
          - type: 'null'
          title: Username
      required:
      - connection_settings
      title: SlackNotificationSettings
      type: object
    StorageReference:
      properties:
        access_parameters:
          anyOf:
          - {}
          - type: 'null'
          title: Access Parameters
        reference:
          anyOf:
          - type: string
          - additionalProperties: true
            type: object
          title: Reference
        storage_type:
          anyOf:
          - type: string
          - type: 'null'
          default: S3
          title: Storage Type
      required:
      - reference
      title: StorageReference
      type: object
    SystemSetupResultDTO:
      properties:
        success:
          default: false
          title: Success
          type: boolean
      title: SystemSetupResultDTO
      type: object
    TaskModel:
      description: Task record persisted in DocumentDB.
      properties:
        duration_ms:
          anyOf:
          - type: integer
          - type: 'null'
          title: Duration Ms
        error:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Error
        execution_id:
          title: Execution Id
          type: string
        id:
          anyOf:
          - type: string
          - type: 'null'
          title: Id
        input_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Input Payload
        input_stash:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Stash of internal sequence outputs collected
          title: Input Stash
        internal_executor_slug:
          title: Internal Executor Slug
          type: string
        metadata:
          anyOf:
          - {}
          - type: 'null'
          title: Metadata
        output_stash:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Stash of internal sequence
          title: Output Stash
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        progress:
          default: 0
          title: Progress
          type: number
        resource_ref:
          anyOf:
          - type: string
          - type: 'null'
          title: Resource Ref
        result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Result Payload
        result_payload_artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Artifact ID if task result was artifactized
          title: Result Payload Artifact Id
        result_payload_materialization_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Materialization ID if task result was artifactized
          title: Result Payload Materialization Id
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        startDate:
          format: date-time
          title: Startdate
          type: string
        status:
          title: Status
          type: string
        stopDate:
          anyOf:
          - format: date-time
            type: string
          - type: 'null'
          title: Stopdate
        task_description:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Description
        task_id:
          title: Task Id
          type: string
        task_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Name
        task_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Slug
        task_token:
          title: Task Token
          type: string
        task_type:
          title: Task Type
          type: string
        team_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Team Id
        update_ts:
          anyOf:
          - type: integer
          - type: 'null'
          title: Update Ts
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
        user_input_data_argument:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: User Input Data Argument
        user_input_validator_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: User Input Validator Slug
        workflow_id:
          title: Workflow Id
          type: string
        workflow_progress_end:
          title: Workflow Progress End
          type: number
        workflow_progress_start:
          title: Workflow Progress Start
          type: number
      required:
      - task_token
      - task_type
      - status
      - workflow_id
      - execution_id
      - internal_executor_slug
      - workflow_progress_start
      - workflow_progress_end
      title: TaskModel
      type: object
    TemporalBucket:
      properties:
        count:
          title: Count
          type: integer
        created_at:
          title: Created At
          type: string
        hour:
          title: Hour
          type: string
      required:
      - count
      - hour
      - created_at
      title: TemporalBucket
      type: object
    TemporalFeatureResponse:
      properties:
        buckets:
          default: []
          items:
            $ref: '#/components/schemas/TemporalBucket'
          title: Buckets
          type: array
        count:
          default: 0
          title: Count
          type: integer
        feature_type:
          default: temporal
          enum:
          - consolidated
          - temporal
          title: Feature Type
          type: string
      title: TemporalFeatureResponse
      type: object
    TransportDataModel_Any_:
      properties:
        metadata:
          anyOf:
          - {}
          - type: 'null'
          title: Metadata
        payload_type:
          $ref: '#/components/schemas/PayloadTypesEnum'
          default: FULL
        storage_ref:
          anyOf:
          - $ref: '#/components/schemas/StorageReference'
          - type: 'null'
        transport_payload:
          title: Transport Payload
        transport_preview:
          anyOf:
          - {}
          - type: 'null'
          title: Transport Preview
      title: TransportDataModel[Any]
      type: object
    TriggerAcquireWorkflowDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/AcquireWorkflowInputArgsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerAcquireWorkflowDTO
      type: object
    TriggerAgenticWorkflowDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/AgenticWorkflowInputArgs'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerAgenticWorkflowDTO
      type: object
    TriggerAutomaticEntityExtractionWorkflowDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/EntityExtractionWorkflowArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerAutomaticEntityExtractionWorkflowDTO
      type: object
    TriggerDocumentDeleteDTO:
      description: Trigger DTO for document delete workflow
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/DocumentDeleteArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerDocumentDeleteDTO
      type: object
    TriggerDocumentIngestionDTO:
      description: Trigger DTO for document ingestion workflow
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/DocumentIngestionWorkflowArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerDocumentIngestionDTO
      type: object
    TriggerDocumentReadDTO:
      description: Trigger DTO for document read workflow
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/DocumentReadArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerDocumentReadDTO
      type: object
    TriggerDocumentSearchDTO:
      description: Trigger DTO for document search workflow
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/DocumentSearchArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerDocumentSearchDTO
      type: object
    TriggerEnrichWorkflowDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/EnrichWorkflowInputArgs'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerEnrichWorkflowDTO
      type: object
    TriggerFeatureLookupDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/FeatureLookupArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerFeatureLookupDTO
      type: object
    TriggerMiruSecBatchETLWorkflowArgumentsDTO:
      description: MiruSec-specific ETL workflow arguments.
      properties:
        acquisition_settings:
          $ref: '#/components/schemas/AcquisitionExecutorInputArgsDTO'
        notification_targets:
          anyOf:
          - items:
              $ref: '#/components/schemas/NotificationTargets'
            type: array
          - type: 'null'
          description: Optional list of notification targets where notifications will
            be sent on workflow completion
          title: Notification Targets
        origin_source:
          anyOf:
          - $ref: '#/components/schemas/OriginSourceDescriptor'
          - type: 'null'
          description: Optional origin source metadata for notifications
        poller_settings:
          $ref: '#/components/schemas/MiruSecETLPollerSettings'
        upsert_workspace_id:
          title: Upsert Workspace Id
          type: string
        upsert_workspace_label:
          default: etl_host
          title: Upsert Workspace Label
          type: string
      required:
      - poller_settings
      - acquisition_settings
      title: TriggerMiruSecBatchETLWorkflowArgumentsDTO
      type: object
    TriggerMiruSecBatchETLWorkflowDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/TriggerMiruSecBatchETLWorkflowArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerMiruSecBatchETLWorkflowDTO
      type: object
    TriggerMiruSecDetectorLambdaWorkflowArgumentsDTO:
      description: MiruSec lambda detector workflow arguments.
      properties:
        alert_callback_notification_setting:
          anyOf:
          - $ref: '#/components/schemas/NotificationTargets'
          - type: 'null'
        detector_settings:
          $ref: '#/components/schemas/MiruSecDetectorLambdaSettings'
        notification_targets:
          anyOf:
          - items:
              $ref: '#/components/schemas/NotificationTargets'
            type: array
          - type: 'null'
          description: Optional list of notification targets where notifications will
            be sent on workflow completion
          title: Notification Targets
        origin_source:
          anyOf:
          - $ref: '#/components/schemas/OriginSourceDescriptor'
          - type: 'null'
          description: Optional origin source metadata for notifications
      required:
      - detector_settings
      title: TriggerMiruSecDetectorLambdaWorkflowArgumentsDTO
      type: object
    TriggerMiruSecDetectorLambdaWorkflowDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/TriggerMiruSecDetectorLambdaWorkflowArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerMiruSecDetectorLambdaWorkflowDTO
      type: object
    TriggerSecurityEventQueryDTO:
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/SecurityEventQueryArgumentsDTO'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerSecurityEventQueryDTO
      type: object
    TriggerWorkspaceDeleteWorkflowDTO:
      description: Trigger DTO for Workspace delete workflow.
      properties:
        artifactize_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Artifactize Result Payload
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          title: Primary Correlation Id
          type: string
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        workflow_arguments:
          $ref: '#/components/schemas/WorkspaceDeleteWorkflowArgs'
        workflow_depth:
          anyOf:
          - type: integer
          - type: 'null'
          default: 0
          title: Workflow Depth
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
      required:
      - primary_correlation_id
      - workflow_arguments
      title: TriggerWorkspaceDeleteWorkflowDTO
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
      - loc
      - msg
      - type
      title: ValidationError
      type: object
    WorkflowCancelResultDTO:
      properties:
        cancelled_workflow_ids:
          items:
            type: string
          title: Cancelled Workflow Ids
          type: array
      required:
      - cancelled_workflow_ids
      title: WorkflowCancelResultDTO
      type: object
    WorkflowListModel:
      description: Paginated workflow list response.
      properties:
        has_more:
          default: false
          title: Has More
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/WorkflowModel'
          title: Items
          type: array
        limit:
          default: 30
          title: Limit
          type: integer
        skip:
          default: 0
          title: Skip
          type: integer
        total_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Total Count
      title: WorkflowListModel
      type: object
    WorkflowModel:
      additionalProperties: true
      description: Workflow record persisted in DocumentDB.
      properties:
        child_workflows:
          items:
            $ref: '#/components/schemas/SimplifiedWorkflowDTO'
          title: Child Workflows
          type: array
        continuation_count:
          default: 0
          title: Continuation Count
          type: integer
        continuation_total_cycle_count:
          default: 0
          title: Continuation Total Cycle Count
          type: integer
        contributing_task_count:
          default: 0
          title: Contributing Task Count
          type: integer
        contributing_tasks:
          items:
            $ref: '#/components/schemas/ContributingTaskItemModel'
          title: Contributing Tasks
          type: array
        current_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Current Task Id
        current_task_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Current Task Name
        current_task_status:
          anyOf:
          - $ref: '#/components/schemas/WorkflowStatusEnum'
          - type: string
          - type: 'null'
          title: Current Task Status
        current_task_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Current Task Type
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        detached_from_api:
          default: false
          title: Detached From Api
          type: boolean
        duration_ms:
          anyOf:
          - type: integer
          - type: 'null'
          title: Duration Ms
        error:
          title: Error
        error_from_task_name:
          anyOf:
          - {}
          - type: 'null'
          title: Error From Task Name
        execution_id:
          title: Execution Id
          type: string
        fourth_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Fourth Correlation Id
        id:
          anyOf:
          - type: string
          - type: 'null'
          title: Id
        initial_arguments:
          title: Initial Arguments
        last_50_contributing_tasks:
          items:
            $ref: '#/components/schemas/ContributingTaskItemModel'
          title: Last 50 Contributing Tasks
          type: array
        last_task_result_from:
          anyOf:
          - type: string
          - type: 'null'
          title: Last Task Result From
        last_task_result_payload:
          anyOf:
          - {}
          - type: 'null'
          title: Last Task Result Payload
        name:
          title: Name
          type: string
        nice_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Nice Name
        output:
          anyOf:
          - {}
          - type: 'null'
          title: Output
        parent_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Task Id
        parent_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Workflow Id
        primary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Primary Correlation Id
        progress:
          default: 0
          title: Progress
          type: number
        resource_ref:
          anyOf:
          - type: string
          - type: 'null'
          title: Resource Ref
        result_payload_artifact_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Artifact ID if workflow result was artifactized
          title: Result Payload Artifact Id
        result_payload_materialization_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Materialization ID if workflow result was artifactized
          title: Result Payload Materialization Id
        root_workflow_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Workflow Id
        secondary_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Secondary Correlation Id
        session_group_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Group Id
        startDate:
          format: date-time
          title: Startdate
          type: string
        state_machine_id:
          title: State Machine Id
          type: string
        state_machine_slug:
          anyOf:
          - type: string
          - type: 'null'
          default: Not set
          title: State Machine Slug
        status:
          anyOf:
          - $ref: '#/components/schemas/WorkflowStatusEnum'
          - type: string
          default: PENDING
          title: Status
        stopDate:
          anyOf:
          - format: date-time
            type: string
          - type: 'null'
          title: Stopdate
        team_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Team Id
        third_correlation_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Third Correlation Id
        update_ts:
          anyOf:
          - type: integer
          - type: 'null'
          title: Update Ts
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
        workflow_depth:
          default: 0
          title: Workflow Depth
          type: integer
        workflow_id:
          title: Workflow Id
          type: string
        workflow_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Workflow Token
        workspace_ids:
          items:
            type: string
          title: Workspace Ids
          type: array
      required:
      - execution_id
      - name
      - startDate
      title: WorkflowModel
      type: object
    WorkflowStatusEnum:
      enum:
      - INITIALIZING
      - RUNNING
      - SUCCEEDED
      - SUCCEEDED_PENDING
      - FAILED
      - TIMED_OUT
      - ABORTED
      - PENDING_REDRIVE
      - PENDING
      - QUEUED
      - PENDING_CONTINUATION
      title: WorkflowStatusEnum
      type: string
    WorkflowTriggerResultDTO:
      properties:
        execution_id:
          title: Execution Id
          type: string
        workflow_id:
          title: Workflow Id
          type: string
      required:
      - workflow_id
      - execution_id
      title: WorkflowTriggerResultDTO
      type: object
    WorkspaceAttachDetachResultDTO:
      properties:
        deleted_orphan_edges:
          default: 0
          title: Deleted Orphan Edges
          type: integer
        updated_nodes:
          title: Updated Nodes
          type: integer
        workspace_id:
          title: Workspace Id
          type: string
      required:
      - workspace_id
      - updated_nodes
      title: WorkspaceAttachDetachResultDTO
      type: object
    WorkspaceAttachNodeDTO:
      additionalProperties: false
      properties:
        node_uuid:
          title: Node Uuid
          type: string
      required:
      - node_uuid
      title: WorkspaceAttachNodeDTO
      type: object
    WorkspaceAttachNodesBulkDTO:
      additionalProperties: false
      properties:
        node_uuids:
          items:
            type: string
          title: Node Uuids
          type: array
      required:
      - node_uuids
      title: WorkspaceAttachNodesBulkDTO
      type: object
    WorkspaceCreateDTO:
      additionalProperties: false
      properties:
        entity_name:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional display name.
          title: Entity Name
        label:
          description: Workspace label.
          title: Label
          type: string
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: Optional access policy refs; defaults to the user's default
            policy.
          title: Resource Refs
        workspace_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional workspace id (UUID).
          title: Workspace Id
      required:
      - label
      title: WorkspaceCreateDTO
      type: object
    WorkspaceDeleteResultDTO:
      properties:
        deleted_edges:
          title: Deleted Edges
          type: integer
        deleted_nodes:
          title: Deleted Nodes
          type: integer
        total_candidates:
          title: Total Candidates
          type: integer
        updated_nodes:
          title: Updated Nodes
          type: integer
        workspace_id:
          title: Workspace Id
          type: string
      required:
      - workspace_id
      - total_candidates
      - updated_nodes
      - deleted_nodes
      - deleted_edges
      title: WorkspaceDeleteResultDTO
      type: object
    WorkspaceDeleteWorkflowArgs:
      description: Arguments for the Workspace delete workflow.
      properties:
        workspace_id_to_delete:
          title: Workspace Id To Delete
          type: string
      required:
      - workspace_id_to_delete
      title: WorkspaceDeleteWorkflowArgs
      type: object
    WorkspaceDetachNodeDTO:
      additionalProperties: false
      properties:
        node_uuid:
          title: Node Uuid
          type: string
      required:
      - node_uuid
      title: WorkspaceDetachNodeDTO
      type: object
    WorkspaceDetachNodesBulkDTO:
      additionalProperties: false
      properties:
        node_uuids:
          items:
            type: string
          title: Node Uuids
          type: array
      required:
      - node_uuids
      title: WorkspaceDetachNodesBulkDTO
      type: object
    WorkspaceQueryDTO:
      additionalProperties: false
      properties:
        entity_name_regex:
          anyOf:
          - type: string
          - type: 'null'
          description: Case-insensitive regex filter on entity_name.
          title: Entity Name Regex
        label_regex:
          anyOf:
          - type: string
          - type: 'null'
          description: Case-insensitive regex filter on workspace label.
          title: Label Regex
      title: WorkspaceQueryDTO
      type: object
    WorkspaceQueryInputDTO:
      additionalProperties: false
      properties:
        limit:
          default: 100
          maximum: 1000.0
          minimum: 1.0
          title: Limit
          type: integer
        query:
          $ref: '#/components/schemas/WorkspaceQueryDTO'
        skip:
          default: 0
          minimum: 0.0
          title: Skip
          type: integer
      title: WorkspaceQueryInputDTO
      type: object
    WorkspaceQueryResultDTO:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/WorkspaceResponseDTO'
          title: Items
          type: array
        total:
          title: Total
          type: integer
      required:
      - items
      - total
      title: WorkspaceQueryResultDTO
      type: object
    WorkspaceResponseDTO:
      additionalProperties: false
      properties:
        entity_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Name
        label:
          title: Label
          type: string
        resource_refs:
          items:
            type: string
          title: Resource Refs
          type: array
        team_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Team Id
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
        workspace_id:
          title: Workspace Id
          type: string
      required:
      - workspace_id
      - label
      title: WorkspaceResponseDTO
      type: object
    WorkspaceUpdateDTO:
      additionalProperties: false
      properties:
        entity_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Name
        label:
          anyOf:
          - type: string
          - type: 'null'
          title: Label
        resource_refs:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Resource Refs
      title: WorkspaceUpdateDTO
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
info:
  description: Myqro API backend for Data I/O and Workflows
  title: Myqro API
  version: 1.7.0-dev.28
openapi: 3.1.0
paths:
  /actions/localetl:
    post:
      operationId: triggerLocalETL
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LocalETLExecutorInputArgumentsDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphQueryResultItems'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Local Etl Route
  /auth/refresh:
    post:
      description: Exchange a Cognito refresh token for new ID and access tokens.
        The refresh token is long-lived (30 days by default) and can be used to silently
        renew the short-lived (1 hour) access/ID tokens.
      operationId: refreshToken
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefreshTokenRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshTokenResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Exchange refresh token for new access tokens
      tags:
      - auth
  /callback:
    post:
      operationId: CallbackWithTaskTokenPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalCallbackInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Completetaskpost
  /callback/{task_token}/{callback_type}/{data}:
    get:
      operationId: CallbackWithTaskTokenGET
      parameters:
      - in: path
        name: task_token
        required: true
        schema:
          title: Task Token
          type: string
      - in: path
        name: callback_type
        required: true
        schema:
          $ref: '#/components/schemas/ExternalCallbackTypesEnum'
      - in: path
        name: data
        required: true
        schema:
          title: Data
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalCallbackResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Completetaskget
  /debug/enrich:
    post:
      description: "Debug-oriented acquire \u2192 extract pipeline (no persistence).\n\
        \n1. Acquires data via HTTP **or** uses inline_data.\n2. Runs Liquid entity\
        \ extraction on the acquired data.\n3. Returns the extracted entities (no\
        \ graph / S3 side-effects)."
      operationId: debugEnrich
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DebugEnrichInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DebugEnrichResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Debug Enrich
  /debug/liquid:
    post:
      description: 'Stateless Liquid entity-extraction utility.

        Receives raw content + entity_mapping, runs extract_and_cast_entities,

        and returns the result JSON (or error).'
      operationId: debugLiquidExtract
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiquidExtractInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DebugLiquidResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Debug Liquid Extract
  /debug/seeder/erase:
    post:
      operationId: debugSeederErase
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DebugSeederEraseRequestDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DebugSeederEraseResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Debug Seeder Erase
  /debug/seeder/generate:
    post:
      operationId: debugSeederGenerate
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DebugSeederGenerateRequestDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DebugSeederGenerateResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Debug Seeder Generate
  /feature_store:
    delete:
      operationId: deleteAllFeatures
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAllFeaturesResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete All Features
  /feature_store/list_all:
    get:
      operationId: listAllFeatures
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema: {}
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: List All Features
  /feature_store/query:
    get:
      operationId: queryFeaturesByUserSlugs
      parameters:
      - in: query
        name: unique_user_identifier
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Unique User Identifier
      - in: query
        name: slug
        required: false
        schema:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Slug
      - in: query
        name: after_timestamp
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: After Timestamp
      - in: query
        name: before_timestamp
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Before Timestamp
      - in: query
        name: limit
        required: false
        schema:
          default: 20
          maximum: 100
          title: Limit
          type: integer
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryMultiSlugResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Features By User Slugs
  /feature_store/slug/{slug}:
    get:
      operationId: queryFeaturesBySlug
      parameters:
      - in: path
        name: slug
        required: true
        schema:
          title: Slug
          type: string
      - in: query
        name: limit
        required: false
        schema:
          default: 20
          maximum: 100
          title: Limit
          type: integer
      - in: query
        name: cursor
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Cursor
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryFeaturesResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Features By Slug
  /feature_store/{dedup_key}:
    get:
      operationId: getFeature
      parameters:
      - in: path
        name: dedup_key
        required: true
        schema:
          title: Dedup Key
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/FeatureItemResponse'
                - type: 'null'
                title: Response Getfeature
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Feature
  /governance/access-policies:
    post:
      operationId: createAccessPolicy
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccessPolicyCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Access Policy
  /governance/access-policies/{resource_ref}:
    delete:
      operationId: deleteAccessPolicy
      parameters:
      - in: path
        name: resource_ref
        required: true
        schema:
          title: Resource Ref
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '204':
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Access Policy
    get:
      operationId: getAccessPolicy
      parameters:
      - in: path
        name: resource_ref
        required: true
        schema:
          title: Resource Ref
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Access Policy
    patch:
      operationId: updateAccessPolicy
      parameters:
      - in: path
        name: resource_ref
        required: true
        schema:
          title: Resource Ref
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccessPolicyUpdateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Access Policy
  /governance/artifacts:
    get:
      operationId: listArtifacts
      parameters:
      - in: query
        name: skip
        required: false
        schema:
          default: 0
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 100
          maximum: 500
          minimum: 1
          title: Limit
          type: integer
      - in: query
        name: producer_workflow_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
      - in: query
        name: producer_task_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Task Id
      - in: query
        name: origin
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Origin
      - in: query
        name: commit_state
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/CommitStatesEnum'
          - type: 'null'
          title: Commit State
      - in: query
        name: artifact_category
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Category
      - in: query
        name: tag
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tag
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
              title: Resource Refs
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ArtifactResponseDTO'
                title: Response Listartifacts
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: List Artifacts
    post:
      operationId: createArtifact
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArtifactCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Artifact
  /governance/artifacts/{artifact_id}:
    delete:
      operationId: deleteArtifact
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: query
        name: delete_derivatives
        required: false
        schema:
          default: none
          pattern: ^(none|all)$
          title: Delete Derivatives
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '204':
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Artifact
    get:
      operationId: getArtifact
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Artifact
    patch:
      operationId: updateArtifact
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArtifactUpdateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Artifact
  /governance/artifacts/{artifact_id}/cascade:
    delete:
      operationId: deleteArtifactById
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Deleteartifactbyid
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Artifact Cascade
  /governance/artifacts/{artifact_id}/cleanup:
    delete:
      operationId: cleanupArtifactById
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Cleanupartifactbyid
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Cleanup Artifact
  /governance/artifacts/{artifact_id}/mentions:
    get:
      operationId: listMentionsByArtifact
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: query
        name: skip
        required: false
        schema:
          default: 0
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 100
          maximum: 500
          minimum: 1
          title: Limit
          type: integer
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/MentionResponseDTO'
                title: Response Listmentionsbyartifact
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: List Mentions By Artifact
  /governance/artifacts/{artifact_id}/state:
    patch:
      operationId: updateArtifactState
      parameters:
      - in: path
        name: artifact_id
        required: true
        schema:
          title: Artifact Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArtifactUpdateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Artifact State
  /governance/entities/{entity_id}:
    delete:
      operationId: deleteEntityById
      parameters:
      - in: path
        name: entity_id
        required: true
        schema:
          title: Entity Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Deleteentitybyid
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Entity By Id
  /governance/materializations:
    get:
      operationId: listMaterializations
      parameters:
      - in: query
        name: skip
        required: false
        schema:
          default: 0
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 100
          maximum: 500
          minimum: 1
          title: Limit
          type: integer
      - in: query
        name: subject_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Subject Id
      - in: query
        name: store_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Store Id
      - in: query
        name: state
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/CommitStatesEnum'
          - type: 'null'
          title: State
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/MaterializationResponseDTO'
                title: Response Listmaterializations
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: List Materializations
    post:
      operationId: createMaterialization
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MaterializationCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaterializationResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Materialization
  /governance/materializations/bulk:
    post:
      operationId: createMaterializationsBulk
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MaterializationBulkCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/MaterializationResponseDTO'
                title: Response Creatematerializationsbulk
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Materializations Bulk
  /governance/materializations/{materialization_id}:
    delete:
      operationId: deleteMaterialization
      parameters:
      - in: path
        name: materialization_id
        required: true
        schema:
          title: Materialization Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '204':
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Materialization
    get:
      operationId: getMaterialization
      parameters:
      - in: path
        name: materialization_id
        required: true
        schema:
          title: Materialization Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaterializationResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Materialization
  /governance/materializations/{materialization_id}/raw:
    get:
      operationId: getMaterializationRawData
      parameters:
      - in: path
        name: materialization_id
        required: true
        schema:
          title: Materialization Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                title: Response Getmaterializationrawdata
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Materialization Raw
  /governance/mentions:
    get:
      operationId: listMentions
      parameters:
      - in: query
        name: skip
        required: false
        schema:
          default: 0
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 100
          maximum: 500
          minimum: 1
          title: Limit
          type: integer
      - in: query
        name: artifact_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Artifact Id
      - in: query
        name: entity_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Entity Id
      - in: query
        name: extractor
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Extractor
      - in: query
        name: state
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/CommitStatesEnum'
          - type: 'null'
          title: State
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/MentionResponseDTO'
                title: Response Listmentions
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: List Mentions
    post:
      operationId: createMention
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MentionCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MentionResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Mention
  /governance/mentions/bulk:
    post:
      operationId: createMentionsBulk
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MentionBulkCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/MentionResponseDTO'
                title: Response Creatementionsbulk
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Mentions Bulk
  /governance/mentions/{mention_id}:
    delete:
      operationId: deleteMention
      parameters:
      - in: path
        name: mention_id
        required: true
        schema:
          title: Mention Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '204':
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Mention
    get:
      operationId: getMention
      parameters:
      - in: path
        name: mention_id
        required: true
        schema:
          title: Mention Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MentionResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Mention
  /governance/orphans:
    delete:
      operationId: cleanOrphanGovernanceEntries
      parameters:
      - in: query
        name: entry_type
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/OrphanEntryTypesEnum'
          - type: 'null'
          title: Entry Type
      - in: query
        name: skip
        required: false
        schema:
          default: 0
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 1000
          maximum: 5000
          minimum: 1
          title: Limit
          type: integer
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Cleanorphangovernanceentries
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Clean Orphans
    get:
      operationId: findOrphanGovernanceEntries
      parameters:
      - in: query
        name: entry_type
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/OrphanEntryTypesEnum'
          - type: 'null'
          title: Entry Type
      - in: query
        name: skip
        required: false
        schema:
          default: 0
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 1000
          maximum: 5000
          minimum: 1
          title: Limit
          type: integer
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Findorphangovernanceentries
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Find Orphans
  /governance/resolve-policies:
    post:
      operationId: resolvePolicies
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolvePoliciesRequestDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema: {}
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Resolve Policies
  /graph/batch:
    put:
      operationId: batchUpdate
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/GraphUpdateSingleEntityInputDTO'
              title: Items
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/GraphNodeReturnDTO'
                title: Response Batchupdate
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Batch Update Route
  /graph/edge:
    post:
      operationId: createEdge
      parameters:
      - description: Target workspace for the new edge(s)
        in: query
        name: workspace_id
        required: true
        schema:
          description: Target workspace for the new edge(s)
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/GraphCreateEdgeDTO'
              - items:
                  $ref: '#/components/schemas/GraphCreateEdgeDTO'
                type: array
              title: Body
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/GraphEdgeReturnDTO'
                - items:
                    $ref: '#/components/schemas/GraphEdgeReturnDTO'
                  type: array
                title: Response Createedge
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Edge Route
  /graph/edge/{uuid}:
    delete:
      operationId: deleteEdge
      parameters:
      - in: path
        name: uuid
        required: true
        schema:
          title: Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                title: Response Deleteedge
                type: integer
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Edge Route
    get:
      operationId: getEdge
      parameters:
      - in: path
        name: uuid
        required: true
        schema:
          title: Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphEdgeReturnDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Edge Route
    put:
      operationId: updateEdge
      parameters:
      - in: path
        name: uuid
        required: true
        schema:
          title: Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphUpdateEdgeDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphEdgeReturnDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Edge Route
  /graph/edge_bulk:
    post:
      operationId: createEdgesBulk
      parameters:
      - description: Target workspace for all edges
        in: query
        name: workspace_id
        required: true
        schema:
          description: Target workspace for all edges
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/GraphCreateEdgeDTO'
              maxItems: 200
              title: Body
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/GraphEdgeReturnDTO'
                title: Response Createedgesbulk
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Edges Bulk
  /graph/insights/{workspace_id}:
    post:
      operationId: getGraphInsights
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphInsightsInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphInsightsResult'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Graph Insights
  /graph/insights/{workspace_id}/invalidate:
    post:
      operationId: invalidateGraphInsights
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphInsightsCacheInvalidateResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Invalidate Graph Insights
  /graph/node:
    post:
      operationId: createNode
      parameters:
      - description: Target workspace for the new node
        in: query
        name: workspace_id
        required: true
        schema:
          description: Target workspace for the new node
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphCreateNodeDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphNodeReturnDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Node
  /graph/node/{uuid}:
    delete:
      operationId: deleteNode
      parameters:
      - in: path
        name: uuid
        required: true
        schema:
          title: Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                title: Response Deletenode
                type: integer
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Node
    get:
      operationId: getNode
      parameters:
      - in: path
        name: uuid
        required: true
        schema:
          title: Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphNodeReturnDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Node
    put:
      operationId: updateNode
      parameters:
      - in: path
        name: uuid
        required: true
        schema:
          title: Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphUpdateNodeDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphNodeReturnDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Node
  /graph/node_bulk:
    post:
      operationId: createNodesBulk
      parameters:
      - description: Target workspace for all nodes
        in: query
        name: workspace_id
        required: true
        schema:
          description: Target workspace for all nodes
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/GraphCreateNodeDTO'
              maxItems: 200
              title: Body
              type: array
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/GraphNodeReturnDTO'
                title: Response Createnodesbulk
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Nodes Bulk
  /graph/query/delete:
    post:
      operationId: deleteGraphEntitesByQuery
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphQueryInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphDeleteEntitiesResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Graph Items
  /graph/query/find:
    post:
      operationId: findGraphEntitiesByQuery
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphQueryInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphQueryResult'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Graph Items
  /graph/query/update:
    put:
      operationId: updateGraphEntitiesByQuery
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphUpdateMultipleEntityInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphUpdateMultipleEntityResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Graph Items
  /identity_feature_store:
    delete:
      operationId: deleteAllIdentities
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAllIdentitiesResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete All Identities
  /identity_feature_store/query:
    get:
      operationId: queryIdentities
      parameters:
      - in: query
        name: identity_key
        required: true
        schema:
          title: Identity Key
          type: string
      - in: query
        name: order_by
        required: false
        schema:
          default: created_ts
          enum:
          - created_ts
          - updated_ts
          title: Order By
          type: string
      - in: query
        name: limit
        required: false
        schema:
          default: 20
          maximum: 100
          title: Limit
          type: integer
      - in: query
        name: cursor
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Cursor
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryIdentitiesResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Identities
  /identity_feature_store/{identity_key}/{identity_value}:
    delete:
      operationId: deleteIdentity
      parameters:
      - in: path
        name: identity_key
        required: true
        schema:
          title: Identity Key
          type: string
      - in: path
        name: identity_value
        required: true
        schema:
          title: Identity Value
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteIdentityResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Identity
    get:
      operationId: getIdentity
      parameters:
      - in: path
        name: identity_key
        required: true
        schema:
          title: Identity Key
          type: string
      - in: path
        name: identity_value
        required: true
        schema:
          title: Identity Value
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/IdentityFeatureModel'
                - type: 'null'
                title: Response Getidentity
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Identity
  /knowledge-base/read:
    post:
      description: Read a document from the Knowledge Base directly without Step Functions
        workflow. Suitable for debugging and immediate responses on non-large documents.
      operationId: directDocumentRead
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DocumentReadArgumentsDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentReadResult'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Direct document read (synchronous)
  /knowledge-base/search:
    post:
      description: Search documents in the Knowledge Base directly without Step Functions
        workflow. Suitable for debugging and immediate responses on non-large document
        sets.
      operationId: directDocumentSearch
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DocumentSearchArgumentsDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentSearchResult'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Direct document search (synchronous)
  /notifications/check:
    post:
      operationId: checkNotificationDestination
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckNotificationDestinationDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckNotificationResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Check Notification Destination
  /security_alerts:
    delete:
      operationId: deleteAllAlerts
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAllAlertsResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete All Alerts
    post:
      operationId: createAlerts
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExternalAlertsInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateExternalAlertsResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Ingest external alerts
  /security_alerts/query:
    get:
      operationId: queryAlerts
      parameters:
      - in: query
        name: producer_workflow_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
      - in: query
        name: evaluator_name
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Evaluator Name
      - in: query
        name: limit
        required: false
        schema:
          default: 20
          maximum: 100
          title: Limit
          type: integer
      - in: query
        name: cursor
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Cursor
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryAlertsResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Alerts
  /security_alerts/{alert_uuid}:
    get:
      operationId: getAlert
      parameters:
      - in: path
        name: alert_uuid
        required: true
        schema:
          title: Alert Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityAlert'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Alert
  /security_events:
    delete:
      operationId: deleteAllEvents
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAllEventsResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete All Events
  /security_events/evaluators:
    get:
      operationId: listEvaluators
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEvaluatorsResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: List Evaluators
  /security_events/query:
    get:
      operationId: queryEvents
      parameters:
      - in: query
        name: origin_hash
        required: false
        schema:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Origin Hash
      - in: query
        name: producer_workflow_id
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Producer Workflow Id
      - in: query
        name: limit
        required: false
        schema:
          default: 20
          maximum: 100
          title: Limit
          type: integer
      - in: query
        name: cursor
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Cursor
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryEventsResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Events
  /security_events/{event_uuid}:
    get:
      operationId: getEvent
      parameters:
      - in: path
        name: event_uuid
        required: true
        schema:
          title: Event Uuid
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityEvent'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Event
  /system/components:
    get:
      operationId: getSystemComponentStatuses
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Getsystemcomponentstatuses
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getsystemcomponentstatuses
  /system/environment:
    get:
      operationId: getSystemEnvironment
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Getsystemenvironment
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getsystemenvironment
  /system/force-cleanup-sync:
    post:
      description: "Brute-force synchronous cleanup of ALL data stores \u2014 no filters,\
        \ no prefixes.\n\nDirectly wipes every collection/table/graph without going\
        \ through\nhigher-level helpers that might skip records.\nOnly available when\
        \ STAGE is \"local\"."
      operationId: forceCleanupSync
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Forcecleanupsync
                type: object
          description: Successful Response
      summary: Force Cleanup Sync
  /system/health:
    get:
      operationId: healthRoot
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Healthroot
                type: object
          description: Successful Response
      summary: Healthroot
  /system/identity:
    get:
      description: 'Return the authenticated caller''s identity information.


        This endpoint shows the complete identity context extracted from the JWT token,

        including both legacy Cognito fields and new IST fields for principal-based
        auth.'
      operationId: getCallerIdentity
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Getcalleridentity
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getcalleridentity
  /system/lambda:
    get:
      operationId: getAWSSessionInfo
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Getawssessioninfo
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getlambdainfo
  /system/liquid:
    post:
      description: 'Stateless Liquid entity-extraction utility.

        Receives raw content + entity_mapping, runs extract_and_cast_entities,

        and returns the result JSON (or error).'
      operationId: liquidExtract
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiquidExtractInputDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Liquidextract
                type: object
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      summary: Liquid Extract
  /system/setup:
    post:
      operationId: setupSystem
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - {}
              - type: 'null'
              title: Input Payload
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SystemSetupResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Setupsystem
  /system/test-cleanup:
    post:
      description: "E2E test cleanup endpoint \u2014 seeds test data, wipes all stores,\
        \ and verifies removal.\n\nOnly available when AWS_ENDPOINT_URL is the LocalStack\
        \ URL and STAGE is \"local\".\nIntended for SDK-driven remote E2E integration\
        \ test initialization."
      operationId: testCleanup
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Testcleanup
                type: object
          description: Successful Response
      summary: Test Cleanup
  /system/uvtest:
    get:
      description: 'Test endpoint that blocks for 10 seconds.

        If uvicorn has 1 worker with sync blocking code,

        concurrent requests will complete sequentially (~10s apart).

        If workers > 1 or using thread pool, they''ll complete together.'
      operationId: uvicornBlockingTest
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response Uvicornblockingtest
                type: object
          description: Successful Response
      summary: Uvicorn Blocking Test
  /workflows/available:
    get:
      operationId: getAvailableWorkflows
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/AvailableWorkflowDescriptor'
                title: Response Getavailableworkflows
                type: array
          description: Successful Response
      summary: Getavailableworkflows
  /workflows/query:
    get:
      operationId: queryWorkflows
      parameters:
      - in: query
        name: workflow_ids
        required: false
        schema:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Workflow Ids
      - in: query
        name: primary_correlation_ids
        required: false
        schema:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Primary Correlation Ids
      - in: query
        name: secondary_correlation_ids
        required: false
        schema:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Secondary Correlation Ids
      - in: query
        name: statuses
        required: false
        schema:
          anyOf:
          - items:
              $ref: '#/components/schemas/WorkflowStatusEnum'
            type: array
          - type: 'null'
          title: Statuses
      - description: Filter by state machine slug (workflow types).
        in: query
        name: state_machine_slug
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by state machine slug (workflow types).
          title: State Machine Slug
      - description: Number of items to skip (offset-based pagination).
        in: query
        name: skip
        required: false
        schema:
          default: 0
          description: Number of items to skip (offset-based pagination).
          minimum: 0
          title: Skip
          type: integer
      - in: query
        name: limit
        required: false
        schema:
          default: 30
          maximum: 500
          minimum: 1
          title: Limit
          type: integer
      - description: 'MongoDB-style sort as JSON. Example: {"startDate": -1, "status":
          1}. Use 1 for ascending, -1 for descending.'
        in: query
        name: order_by
        required: false
        schema:
          default: '{"startDate": -1}'
          description: 'MongoDB-style sort as JSON. Example: {"startDate": -1, "status":
            1}. Use 1 for ascending, -1 for descending.'
          title: Order By
          type: string
      - description: Include total count of matching workflows (may be expensive for
          large result sets).
        in: query
        name: include_total_count
        required: false
        schema:
          default: false
          description: Include total count of matching workflows (may be expensive
            for large result sets).
          title: Include Total Count
          type: boolean
      - description: Only return root workflows (exclude child/sub-workflows).
        in: query
        name: root_only
        required: false
        schema:
          default: false
          description: Only return root workflows (exclude child/sub-workflows).
          title: Root Only
          type: boolean
      - description: Include child workflows in the response.
        in: query
        name: include_children
        required: false
        schema:
          default: false
          description: Include child workflows in the response.
          title: Include Children
          type: boolean
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowListModel'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getworkflowsbyfilters
  /workflows/single/{workflow_id}:
    get:
      operationId: getWorkflow
      parameters:
      - in: path
        name: workflow_id
        required: true
        schema:
          title: Workflow Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowModel'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getworkflow
  /workflows/single/{workflow_id}/cancel:
    post:
      operationId: cancelWorkflow
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - description: Cancellation reason
        in: query
        name: reason
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Cancellation reason
          title: Reason
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowCancelResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Cancelworkflow
  /workflows/single/{workflow_id}/raw:
    get:
      operationId: getWorkflowRawData
      parameters:
      - in: path
        name: workflow_id
        required: true
        schema:
          title: Workflow Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                title: Response Getworkflowrawdata
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Getworkflowrawdata
  /workflows/single/{workflow_id}/semantic:
    get:
      operationId: getSemanticWorkflow
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SemanticWorkflowDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Semantic Workflow
  /workflows/single/{workflow_id}/tasks:
    get:
      operationId: getTasks
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - description: Number of items to skip
        in: query
        name: skip
        required: false
        schema:
          default: 0
          description: Number of items to skip
          minimum: 0
          title: Skip
          type: integer
      - description: Maximum number of items to retrieve
        in: query
        name: limit
        required: false
        schema:
          default: 999
          description: Maximum number of items to retrieve
          minimum: 1
          title: Limit
          type: integer
      - description: 'MongoDB-style sort as JSON. Example: {"startDate": -1}. Use
          1 for ascending, -1 for descending.'
        in: query
        name: order_by
        required: false
        schema:
          default: '{"startDate": -1}'
          description: 'MongoDB-style sort as JSON. Example: {"startDate": -1}. Use
            1 for ascending, -1 for descending.'
          title: Order By
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/TaskModel'
                title: Response Gettasks
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Gettasks
  /workflows/single/{workflow_id}/tasks/simplified:
    get:
      operationId: getTasksSimplified
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - description: Number of items to skip
        in: query
        name: skip
        required: false
        schema:
          default: 0
          description: Number of items to skip
          minimum: 0
          title: Skip
          type: integer
      - description: Maximum number of items to retrieve
        in: query
        name: limit
        required: false
        schema:
          default: 10
          description: Maximum number of items to retrieve
          minimum: 1
          title: Limit
          type: integer
      - description: 'MongoDB-style sort as JSON. Example: {"startDate": -1}. Use
          1 for ascending, -1 for descending.'
        in: query
        name: order_by
        required: false
        schema:
          default: '{"startDate": -1}'
          description: 'MongoDB-style sort as JSON. Example: {"startDate": -1}. Use
            1 for ascending, -1 for descending.'
          title: Order By
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SimplifiedTaskDTO'
                title: Response Gettaskssimplified
                type: array
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Gettaskssimplified
  /workflows/single/{workflow_id}/tasks/{task_id}:
    get:
      operationId: getTask
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - description: The task id
        in: path
        name: task_id
        required: true
        schema:
          description: The task id
          title: Task Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskModel'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Gettask
  /workflows/single/{workflow_id}/tasks/{task_id}/raw:
    get:
      operationId: getTaskRawData
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - description: The task id
        in: path
        name: task_id
        required: true
        schema:
          description: The task id
          title: Task Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                title: Response Gettaskrawdata
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Gettaskrawdata
  /workflows/single/{workflow_id}/tree:
    get:
      operationId: getWorkflowTree
      parameters:
      - description: The workflow_id
        in: path
        name: workflow_id
        required: true
        schema:
          description: The workflow_id
          title: Workflow Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimplifiedWorkflowDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Workflow Tree
  /workflows/trigger/acquire:
    post:
      operationId: triggerAcquireWorkflow
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerAcquireWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Acquire Workflow
  /workflows/trigger/agentic:
    post:
      operationId: triggerAgenticWorkflow
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerAgenticWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Agentic Workflow
  /workflows/trigger/automatic_extract:
    post:
      operationId: triggerAutomaticExtractWorkflow
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerAutomaticEntityExtractionWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Extract Workflow
  /workflows/trigger/feature-store/lookup:
    post:
      description: Trigger a Step Functions workflow to look up feature-store records
        for a user.
      operationId: triggerFeatureLookup
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerFeatureLookupDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger feature lookup workflow
  /workflows/trigger/http_acquisition_to_graphdb:
    post:
      operationId: triggerHttpAcquisitionToGraphDB
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerEnrichWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Enrich Workflow
  /workflows/trigger/knowledge-base/delete:
    post:
      description: Trigger a Step Functions workflow to delete a document from the
        Knowledge Base
      operationId: triggerDocumentDelete
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerDocumentDeleteDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger document delete workflow
  /workflows/trigger/knowledge-base/ingest:
    post:
      description: Trigger a Step Functions workflow to ingest a document into the
        Knowledge Base
      operationId: triggerDocumentIngestion
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerDocumentIngestionDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentIngestionTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger document ingestion workflow
  /workflows/trigger/knowledge-base/read:
    post:
      description: Trigger a Step Functions workflow to read a document from the Knowledge
        Base
      operationId: triggerDocumentRead
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerDocumentReadDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger document read workflow
  /workflows/trigger/knowledge-base/search:
    post:
      description: Trigger a Step Functions workflow to search documents in the Knowledge
        Base
      operationId: triggerDocumentSearch
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerDocumentSearchDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger document search workflow
  /workflows/trigger/mirusec_batch_etl:
    post:
      operationId: triggerMiruSecBatchETL
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerMiruSecBatchETLWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Mirusec Batch Etl Workflow
  /workflows/trigger/mirusec_detector_lambda:
    post:
      operationId: triggerMiruSecDetectorLambda
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerMiruSecDetectorLambdaWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Mirusec Detector Lambda Workflow
  /workflows/trigger/security-event-store/query:
    post:
      description: Trigger a Step Functions workflow to query the security event store
        with the supplied filters.
      operationId: triggerSecurityEventQuery
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerSecurityEventQueryDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger security-event-store query workflow
  /workflows/trigger/summarize:
    post:
      description: Trigger a Step Functions workflow to perform hierarchical document
        summarization using pairwise LLM processing
      operationId: triggerHierarchicalSummarize
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HierarchicalSummarizeWorkflowTriggerDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger hierarchical summarization workflow
  /workflows/trigger/workspace/delete:
    post:
      operationId: triggerWorkspaceDeleteWorkflow
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerWorkspaceDeleteWorkflowDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowTriggerResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Trigger Workspace Delete Workflow
  /workspaces:
    post:
      operationId: createWorkspace
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceCreateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Create Workspace
  /workspaces/query:
    post:
      operationId: queryWorkspaces
      parameters:
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceQueryInputDTO'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceQueryResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Query Workspaces
  /workspaces/{workspace_id}:
    delete:
      operationId: deleteWorkspace
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceDeleteResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Delete Workspace
    get:
      operationId: getWorkspace
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Get Workspace
    patch:
      operationId: updateWorkspace
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceUpdateDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceResponseDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Update Workspace
  /workspaces/{workspace_id}/attach_node:
    post:
      operationId: attachNodeToWorkspace
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceAttachNodeDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceAttachDetachResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Attach Node
  /workspaces/{workspace_id}/attach_nodes_bulk:
    post:
      operationId: attachNodesToWorkspaceBulk
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceAttachNodesBulkDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceAttachDetachResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Attach Nodes Bulk
  /workspaces/{workspace_id}/detach_node:
    post:
      operationId: detachNodeFromWorkspace
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceDetachNodeDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceAttachDetachResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Detach Node
  /workspaces/{workspace_id}/detach_nodes_bulk:
    post:
      operationId: detachNodesFromWorkspaceBulk
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          title: Workspace Id
          type: string
      - in: header
        name: x-mvz-auth
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Mvz-Auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceDetachNodesBulkDTO'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceAttachDetachResultDTO'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
      - HTTPBearer: []
      summary: Detach Nodes Bulk