create_card

{
  "type": "object",
  "properties": {
    "amount_cents": {
      "type": "number",
      "description": "Card funding amount in CENTS, not dollars (minimum 100). 100 = $1.00 and 2500 = $25.00 — a value like 25 would be $0.25. Company-governed connections have no maximum; personal accounts are capped by their plan — call get_plan for the limits in effect."
    },
    "connected_card_id": {
      "type": "string",
      "description": "Multi-card: issue against a SPECIFIC added card (an id from the user's added cards, see list_added_cards) instead of the newest active one. Omit for the default."
    },
    "pending_card_id": {
      "type": "string",
      "description": "Only when retrying an approval_pending purchase whose preset has since changed: the cardId from that earlier answer, together with purchase_key. The older approval link is retired once the replacement is minted. Never pass it for a different purchase."
    },
    "purchase_key": {
      "type": "string",
      "description": "The purchaseKey from the same approval_pending answer as pending_card_id; the pair proves the retry is for that purchase."
    },
    "source": {
      "type": "string",
      "enum": [
        "issued"
      ],
      "description": "Force the card to be funded from the user's cash balance (the issued path: KYC + wallet funding) even when they have an added or vaulted card or would otherwise be offered the vault. Use it only after the user explicitly picks the balance option. Omit for the default (an active added card wins; first-time users get the vault link)."
    },
    "restart_setup": {
      "type": "boolean",
      "description": "Set true ONLY when the user lost or never received a vault link, it expired (about 15 minutes), or they want to add ANOTHER card. Never needed on the first call or for normal retries. amount_cents is still required on this call (the link itself carries no amount)."
    },
    "funds_source": {
      "type": "string",
      "enum": [
        "onramp_flow",
        "company_flow"
      ],
      "description": "Where the card funds come from. OMIT unless instructed: the server applies the right default (company-connected accounts use the company wallet automatically when the company enables it). company_flow = the company's wallet funds the card; onramp_flow = the user's own wallet."
    },
    "type": {
      "type": "string",
      "enum": [
        "single_use",
        "multi_use"
      ],
      "description": "Card behavior. 'single_use' (default) closes after its first approved charge — right for one-off purchases. 'multi_use' stays open across charges until its total limit is spent — right for subscriptions and recurring merchants. Multi-use cards can be paused (pause_card), resumed (resume_card), and resized (update_card_limit)."
    },
    "expires_at": {
      "type": "string",
      "description": "Optional hard expiry for a multi-use card (ISO-8601 with timezone, e.g. \"2027-01-01T00:00:00Z\"). Must be in the future, at most 365 days out. The card closes automatically when it passes."
    },
    "preset": {
      "description": "Preset for this card: a template name (ai_labs, weekday_meals, cli_only, daily), comma-separated templates, a saved preset name/id, inline JSON privileges, or { name?, privileges }. Adds restrictions only — omit for a normal unrestricted card.",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "privileges": {
              "type": "array",
              "items": {}
            }
          },
          "required": [
            "privileges"
          ]
        }
      ]
    },
    "scope_preset": {
      "type": "string",
      "enum": [
        "ai_labs"
      ],
      "description": "Silent alias for preset 'ai_labs': a multi-use card restricted to AI-lab merchants (OpenAI, Anthropic, Gemini); charges anywhere else are declined at authorization. AI cards earn boosted tokenback on eligible spend. Implies type 'multi_use'. Prefer `preset`."
    }
  },
  "required": [
    "amount_cents"
  ]
}