JobAccepted

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ffpipe-dev/json-schema/ffpipe-dev-job-accepted-schema.json",
  "title": "JobAccepted",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ffpipe-dev-openapi.json#/components/schemas/JobAccepted",
  "type": "object",
  "required": [
    "jobId",
    "status",
    "statusUrl"
  ],
  "properties": {
    "jobId": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "awaiting_upload"
      ],
      "description": "`queued` for pull mode; `awaiting_upload` for upload mode (the job queues when your PUT completes)."
    },
    "statusUrl": {
      "type": "string",
      "format": "uri",
      "description": "Free, token-gated status endpoint for this job. Keep it: the token is the only proof of ownership and is not recoverable."
    },
    "fundingSource": {
      "type": "string",
      "enum": [
        "x402",
        "credits",
        "voucher"
      ],
      "description": "What paid for this acceptance: `x402` (the on-chain payment you signed), `credits` (your account's balance, when you sent a Bearer token) or `voucher` (a free retry). Stated back to you so a caller holding both a token and a wallet never has to guess which one it just spent."
    },
    "uploadUrl": {
      "type": "string",
      "format": "uri",
      "description": "Upload mode only: PUT the raw bytes here before `uploadExpiresAt`. Keep it - this response is the ONLY place the upload token is handed out (the status route never repeats it), and it is not recoverable."
    },
    "uploadExpiresAt": {
      "type": "string",
      "format": "date-time",
      "description": "Upload mode only: deadline for the PUT. Past it the job becomes a terminal `error` with no refund."
    }
  }
}