UploadContract

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/majr-app/json-schema/majr-app-upload-contract-schema.json",
  "title": "UploadContract",
  "description": "POST /v1/uploads 201 response: where to PUT, and the source to encode.",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/encoding-openapi.json#/components/schemas/UploadContract",
  "type": "object",
  "required": [
    "uploadId",
    "source",
    "upload",
    "note"
  ],
  "properties": {
    "uploadId": {
      "type": "string"
    },
    "source": {
      "$ref": "#/$defs/ObjectRef",
      "description": "Pass this as `source` to POST /v1/encode once the PUT succeeds."
    },
    "upload": {
      "type": "object",
      "required": [
        "url",
        "method",
        "headers",
        "urlExpiresAt"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Presigned PUT target."
        },
        "method": {
          "type": "string",
          "const": "PUT"
        },
        "headers": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Headers you MUST send on the PUT (e.g. Content-Type when signed)."
        },
        "urlExpiresAt": {
          "type": "string",
          "format": "date-time",
          "description": "When this presigned PUT URL stops working."
        }
      }
    },
    "note": {
      "type": "string"
    }
  },
  "$defs": {
    "ObjectRef": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "bucket",
        "key"
      ],
      "properties": {
        "bucket": {
          "type": "string",
          "minLength": 1
        },
        "key": {
          "type": "string",
          "minLength": 1
        }
      }
    }
  }
}