VerifiersExecuteRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fleetai-com/json-schema/fleetai-com-verifiers-execute-request-schema.json",
  "title": "VerifiersExecuteRequest",
  "description": "Request model for function verification.",
  "x-generated": "2026-10-27",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fleetai-com-openapi.yml#/components/schemas/VerifiersExecuteRequest",
  "properties": {
    "verifier_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Verifier Id",
      "description": "Verifier lineage id. Recorded on async job responses and used to scope task-verifier routing; it does not affect attribution. The execution is filed against the version whose sha256 is the code that ran, or a newly minted one when no stored version holds it."
    },
    "verifier_version_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Verifier Version Id",
      "description": "Concrete verifier_versions.id to execute. The stored version's code is rebuilt and run as-is; key/sha256 inputs are ignored and no verifier rows are ever created. Mutually exclusive with bundle."
    },
    "expected_pinned_source_sha256": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Expected Pinned Source Sha256",
      "description": "Optional exact UTF-8 source digest for a pinned verifier version. When supplied, execution fails if the stored source has changed."
    },
    "compatibility_network_terminal_receipt": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Compatibility Network Terminal Receipt",
      "description": "Internal verify_environment attestation input for an immutable unadmitted compatibility-retention task. The public API validates this receipt against the persisted terminal source and exact versioned evidence bytes; it is never forwarded to verifier code."
    },
    "key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Key",
      "description": "Key of the verifier artifact"
    },
    "sha256": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sha256",
      "description": "SHA256 hash of the function (auto-generated if bundle is provided)"
    },
    "bundle": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bundle",
      "description": "Base64 encoded bundle data"
    },
    "args": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Args",
      "description": "Base64 encoded cloudpickled args"
    },
    "args_array": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Args Array",
      "description": "Array of argument values to pass to the function"
    },
    "conversation_session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Conversation Session Id",
      "description": "Optional session reference whose persisted transcript is loaded server-side and passed to the verifier as the conversation kwarg. This keeps large tool results out of caller and queue payloads."
    },
    "conversation_expected_message_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Conversation Expected Message Count",
      "description": "Optional exact persisted-message boundary for conversation_session_id. The server fails closed unless positions 0 through count-1 are all present and conflict-free across the authoritative store and fallback."
    },
    "conversation_requires_exact_boundary": {
      "type": "boolean",
      "title": "Conversation Requires Exact Boundary",
      "description": "Require an exact server-owned persisted-message boundary. Task-owned conversation verifiers set this so a missing Agent Runtime sync receipt fails closed while legacy conversation references remain compatible.",
      "default": false
    },
    "function_name": {
      "type": "string",
      "title": "Function Name",
      "description": "Name of the function to execute",
      "default": "verify"
    },
    "timeout": {
      "type": "integer",
      "maximum": 600.0,
      "minimum": 1.0,
      "title": "Timeout",
      "description": "Execution timeout in seconds (minimum 240)",
      "default": 240
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "description": "AWS region for execution"
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Metadata",
      "description": "Additional metadata"
    },
    "comment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Comment",
      "description": "Comment about the function"
    },
    "display_src": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Display Src",
      "description": "Display source code"
    },
    "verifier_runtime_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Verifier Runtime Version",
      "description": "Optional verifier runtime version (ECR tag). If omitted (or set to 'latest'), uses latest cached version."
    },
    "cost_team_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cost Team Id",
      "description": "Optional team UUID for LLMAJ credential selection and cost attribution. Omitted or self-team values use the authenticated team's configured payer. The request is rejected unless an eligible payer-scoped or unscoped llmaj/openai key exists for the default judge model."
    },
    "ups_project": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(foundry|matg)/[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ups Project",
      "description": "Server-set from verified funding context; client values are overwritten."
    },
    "fi_dispatch_grant_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fi Dispatch Grant Id",
      "description": "The caller-owned Fi grant whose UPS project funds this verifier."
    },
    "fi_dispatch_workflow_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 255,
          "minLength": 1,
          "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fi Dispatch Workflow Id",
      "description": "Workflow bound to fi_dispatch_grant_id."
    },
    "sales_product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sales Product Id",
      "description": "Optional active sales-product UUID for exact business-cost attribution. The public API attempts to validate it against the canonical catalog before verifier work is queued. If attribution cannot be validated, the lineage tuple is omitted and verifier execution continues."
    },
    "job_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Job Id",
      "description": "Optional parent eval job UUID for attribution lineage. The job must belong to the authenticated team to be attributed; invalid or unavailable lineage is omitted without blocking execution."
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Session Id",
      "description": "Optional parent eval session UUID for attribution lineage. This does not load conversation messages; use conversation_session_id for that behavior. Invalid or unavailable attribution lineage is omitted without blocking execution."
    },
    "persist": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Persist",
      "description": "If true, persist the verifier to the database"
    },
    "source": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ],
      "title": "Source",
      "description": "Identifier of the caller triggering this execution (e.g. 'execute_and_persist_verifier'). Recorded as trigger_source in the execution record's result meta for provenance."
    },
    "async": {
      "type": "boolean",
      "title": "Async",
      "description": "If true, execute the verifier in the background and return immediately with a job_id (status='pending'). Poll GET /v1/verifiers/jobs/{job_id} for the result. Async runs ignore the `timeout` field and may run far longer than a sync call (bounded by the worker result TTL).",
      "default": false
    }
  },
  "type": "object"
}