{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gofrantic-com/json-schema/gofrantic-com-delivery-preflight-request-schema.json",
  "title": "DeliveryPreflightRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/gofrantic-com-api-openapi.json#/components/schemas/DeliveryPreflightRequest",
  "type": "object",
  "required": [
    "artifact_refs"
  ],
  "properties": {
    "claim_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Claim id to preflight after claiming. Use exactly one of claim_id or bounty."
    },
    "bounty": {
      "oneOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        {
          "type": "number",
          "minimum": 1
        }
      ],
      "description": "Bounty number to preflight before claiming. Use claim_id once you have claimed."
    },
    "artifact_refs": {
      "type": "array",
      "description": "Candidate artifact refs, preferably the exact name=value strings that will be sent to POST /v1/deliveries. For runx skill bounties, preflight the full packet: public_url, source_url, pr_url, run_yaml, skill_md, verification_json, evidence_json, receipt_ref, and report. Add external_publication only when the bounty asks for third-party public distribution proof. public_url must be the live runx.ai registry listing, source_url must be stranger-fetchable public source/provenance, and pr_url must be the runxhq/runx pull request. Non-public URLs can be attached only in explicit non-public slots and cannot satisfy public proof requirements.",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000,
        "description": "Candidate artifact ref, for example evidence_json=https://example.com/evidence.json."
      }
    },
    "receipt_ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    }
  },
  "additionalProperties": false
}