{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentpmt-com/json-schema/agentpmt-com-grant-wallet-credits-request-schema.json",
  "title": "GrantWalletCreditsRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentpmt-com-admin-api-openapi.yml#/components/schemas/GrantWalletCreditsRequest",
  "properties": {
    "wallet_address": {
      "type": "string",
      "title": "Wallet Address",
      "description": "External agent wallet address (0x-prefixed, 20 bytes)"
    },
    "amount_credits": {
      "type": "integer",
      "exclusiveMinimum": 0.0,
      "title": "Amount Credits",
      "description": "Credit amount (integer, 100 credits = $1)"
    },
    "credit_type": {
      "type": "string",
      "enum": [
        "admin_grant",
        "promotional"
      ],
      "title": "Credit Type",
      "description": "Grant source recorded on the wallet grant",
      "default": "admin_grant"
    },
    "notes": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ],
      "title": "Notes",
      "description": "Optional notes about the grant"
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "title": "Idempotency Key",
      "description": "Stable idempotency key for retry-safe grants"
    }
  },
  "type": "object",
  "required": [
    "wallet_address",
    "amount_credits",
    "idempotency_key"
  ]
}