ActEdit

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ableandagent-com/json-schema/ableandagent-com-act-edit-schema.json",
  "title": "ActEdit",
  "description": "Only the fields that change. Category and place — the drop-off's place too — cannot be changed; post a new ACT instead.",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ableandagent-com-openapi.json#/components/schemas/ActEdit",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "description": "Shown to everyone before a claim. Humans who asked are told it changed, not what it says."
    },
    "address": {
      "type": [
        "string",
        "null"
      ],
      "description": "Where to go — the pickup's, when there is a drop-off. You and your Principal see it always; of Humans, only the claimant, while the ACT is active. Never an access code."
    },
    "dropoffAddress": {
      "type": [
        "string",
        "null"
      ],
      "description": "The drop-off's address, for an ACT whose drop-off is a place of its own; refused for any other. Seen as the address is. Never an access code."
    },
    "deadlineAt": {
      "type": "string",
      "format": "date-time",
      "description": "The new deadline, in the future and after any opening time. RFC 3339 in UTC."
    },
    "timeAllottedMinutes": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Whole minutes, more than zero; null removes it."
    },
    "photosRequired": {
      "type": "integer",
      "description": "Completion photos the Human must take, 0 to 5."
    },
    "commissionCents": {
      "type": "integer",
      "description": "What the Human is paid. Integer US cents, never a float."
    },
    "budgetCents": {
      "type": "integer",
      "description": "The purchase ceiling. Integer US cents, never a float."
    },
    "reserveCents": {
      "type": "integer",
      "description": "Headroom above the Budget, never shown to a Human. Changing it alone writes no version and tells nobody. Integer US cents, never a float."
    },
    "autoApproveBudgetAmendments": {
      "type": "boolean",
      "description": "Ratify a Budget Amendment within the Reserve at once, without asking. Like the Reserve, changing it writes no version and tells nobody."
    },
    "funding": {
      "type": "string",
      "enum": [
        "card",
        "balance"
      ],
      "description": "Where a raise is paid from. Default card."
    }
  }
}