FFxF

Where machines can run. Public, no key needed.

{
  "type": "object",
  "properties": {}
}

Plans with their resources and prices (hourly and monthly, in CAD). Public, no key needed.

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Keep only plans offered in this region.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Operating systems and ready-to-use application images. The slug is what create_vm expects. Public, no key needed.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string"
    },
    "plan": {
      "description": "Keep only images that fit this plan.",
      "type": "string"
    },
    "category": {
      "description": "linux, windows, bsd or app.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Credit balance, hourly burn rate and runway, quota and budget caps. Scope: billing.read.

{
  "type": "object",
  "properties": {}
}

The account's machines with their status, addresses and billing. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "status": {
      "description": "e.g. running, stopped, provisioning.",
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "billing": {
      "type": "string",
      "enum": [
        "hourly",
        "monthly"
      ]
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One machine: status, IPv4, IPv6 /64, specs, traffic (Internet only, this traffic month: used_gb, limit_gb, period_ends_at), billing, suspension. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    }
  },
  "required": [
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CPU, memory, disk and network as measured from outside the machine. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month"
      ]
    }
  },
  "required": [
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Runs every check of create_vm and prices it, without creating anything: would_succeed, hourly rate, monthly price, credit required. Call it before create_vm. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "description": "Plan slug from list_plans, e.g. nano."
    },
    "region": {
      "type": "string",
      "description": "Region slug from list_regions, e.g. montreal."
    },
    "image": {
      "type": "string",
      "description": "Image slug from list_images, e.g. debian-13."
    },
    "hostname": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^(?!.*[.-]{2})[a-zA-Z0-9]([a-zA-Z0-9.-]{0,126}[a-zA-Z0-9])?$",
      "description": "Letters, digits, dots and hyphens; no leading, trailing or doubled separator."
    },
    "billing": {
      "type": "string",
      "enum": [
        "hourly",
        "monthly"
      ],
      "description": "Hourly draws on prepaid credit; monthly raises an invoice. Fixed for the life of the machine."
    },
    "ssh_keys": {
      "description": "Fingerprints or ids of SSH keys already on the account (see list_ssh_keys).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "options": {
      "description": "Paid options declared by the plan, by name.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "ipv4": {
      "description": "false orders an IPv6-only machine, cheaper; outbound IPv4 goes through NAT64.",
      "type": "boolean"
    },
    "vpc": {
      "description": "Private network id (list_vpcs) to connect the machine to, in the same region.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "private_only": {
      "description": "No public address at all; needs vpc. Reachable only from the private network, Internet through its gateway. Priced like ipv4: false.",
      "type": "boolean"
    }
  },
  "required": [
    "plan",
    "region",
    "image",
    "hostname",
    "billing"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Orders a machine and spends credit (hourly) or raises an invoice (monthly). Returns the machine and a provisioning action to poll with get_action. Retrying the same order is safe: it is deduplicated for 24 hours. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "description": "Plan slug from list_plans, e.g. nano."
    },
    "region": {
      "type": "string",
      "description": "Region slug from list_regions, e.g. montreal."
    },
    "image": {
      "type": "string",
      "description": "Image slug from list_images, e.g. debian-13."
    },
    "hostname": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^(?!.*[.-]{2})[a-zA-Z0-9]([a-zA-Z0-9.-]{0,126}[a-zA-Z0-9])?$",
      "description": "Letters, digits, dots and hyphens; no leading, trailing or doubled separator."
    },
    "billing": {
      "type": "string",
      "enum": [
        "hourly",
        "monthly"
      ],
      "description": "Hourly draws on prepaid credit; monthly raises an invoice. Fixed for the life of the machine."
    },
    "ssh_keys": {
      "description": "Fingerprints or ids of SSH keys already on the account (see list_ssh_keys).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "options": {
      "description": "Paid options declared by the plan, by name.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "ipv4": {
      "description": "false orders an IPv6-only machine, cheaper; outbound IPv4 goes through NAT64.",
      "type": "boolean"
    },
    "vpc": {
      "description": "Private network id (list_vpcs) to connect the machine to, in the same region.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "private_only": {
      "description": "No public address at all; needs vpc. Reachable only from the private network, Internet through its gateway. Priced like ipv4: false.",
      "type": "boolean"
    },
    "payment": {
      "description": "Monthly only. credit pays from the balance when it covers the invoice.",
      "type": "string",
      "enum": [
        "credit",
        "manual"
      ]
    },
    "password_delivery": {
      "description": "email mails a generated password; none needs at least one SSH key.",
      "type": "string",
      "enum": [
        "email",
        "none"
      ]
    },
    "idempotency_key": {
      "description": "Your own unique value per order. By default one is derived from the order itself.",
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "plan",
    "region",
    "image",
    "hostname",
    "billing"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

start, shutdown (clean ACPI), reboot, or stop (hard power-off). Returns an action to poll with get_action. Scope: vms.action.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "type": {
      "type": "string",
      "enum": [
        "start",
        "shutdown",
        "reboot",
        "stop"
      ]
    }
  },
  "required": [
    "vm",
    "type"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Changes the hostname, inside the guest and in the console. Scope: vms.action.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "hostname": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^(?!.*[.-]{2})[a-zA-Z0-9]([a-zA-Z0-9.-]{0,126}[a-zA-Z0-9])?$",
      "description": "Letters, digits, dots and hyphens; no leading, trailing or doubled separator."
    }
  },
  "required": [
    "vm",
    "hostname"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ERASES THE DISK and redeploys another image. Ask the user first. confirm_hostname must be the machine's exact current hostname. Scope: vms.action.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "image": {
      "type": "string",
      "description": "Image slug from list_images, offered in the machine's region and fitting its plan."
    },
    "confirm_hostname": {
      "type": "string",
      "description": "The machine's exact hostname, typed back as confirmation."
    },
    "ssh_keys": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "password_delivery": {
      "type": "string",
      "enum": [
        "email",
        "none"
      ]
    }
  },
  "required": [
    "vm",
    "image",
    "confirm_hostname"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

DESTROYS the machine and its disk, with no undo and no backup kept. Ask the user first. confirm_hostname must be the machine's exact hostname. Scope: vms.destroy.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "confirm_hostname": {
      "type": "string",
      "description": "The machine's exact hostname, typed back as confirmation."
    },
    "when": {
      "description": "Monthly machines only: at the end of the paid period, or now.",
      "type": "string",
      "enum": [
        "period_end",
        "now"
      ]
    }
  },
  "required": [
    "vm",
    "confirm_hostname"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Follows an asynchronous action (create, reinstall, power…). Poll until status leaves running; on error it carries the reason. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "action"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

History of actions on one machine, from the API and the console. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    }
  },
  "required": [
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

IPv4 and IPv6 addresses of a machine with their reverse DNS, and its private networks. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    }
  },
  "required": [
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sets the PTR record of one of the machine's addresses; null restores the default. Scope: network.write.

{
  "type": "object",
  "properties": {
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "address": {
      "type": "string",
      "description": "An IPv4 or IPv6 address of the machine."
    },
    "hostname": {
      "description": "Fully qualified name, or null to clear.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "vm",
    "address",
    "hostname"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The account's private networks with their range, gateway and connected machines, plus the quota. Scope: vms.read.

{
  "type": "object",
  "properties": {}
}

One private network and the machines on it, with their private address. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Private network id, as returned by list_vpcs or create_vpc."
    }
  },
  "required": [
    "vpc"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates an isolated private network; ready when the call returns. The first usable address (.1) is reserved for the gateway. Scope: network.write.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "cidr": {
      "type": "string",
      "description": "Private IPv4 range from /16 to /29 in 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16, e.g. 10.0.0.0/24."
    },
    "region": {
      "type": "string",
      "description": "Region slug from list_regions, e.g. montreal."
    }
  },
  "required": [
    "name",
    "cidr",
    "region"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Deletes an empty private network. Refused while a machine is still on it: disconnect or destroy those first. Ask the user first. Scope: network.write.

{
  "type": "object",
  "properties": {
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Private network id, as returned by list_vpcs or create_vpc."
    }
  },
  "required": [
    "vpc"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Hot-adds a card on the private network and sets its address in the system, without a restart. configuration: manual means the address must be set by hand in the guest. Connecting again returns the same address. Scope: network.write.

{
  "type": "object",
  "properties": {
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Private network id, as returned by list_vpcs or create_vpc."
    },
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "ip": {
      "description": "Address wanted in the range; default the next free one.",
      "type": "string"
    }
  },
  "required": [
    "vpc",
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Removes the machine's private address and card, without a restart. Refused for the only network of a machine with no public address. Scope: network.write.

{
  "type": "object",
  "properties": {
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Private network id, as returned by list_vpcs or create_vpc."
    },
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    }
  },
  "required": [
    "vpc",
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Joins the target network, then leaves this one, so the machine is never cut off. Keeps the same address ending when free. Scope: network.write.

{
  "type": "object",
  "properties": {
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The network the machine is on now."
    },
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    },
    "to": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The target network."
    }
  },
  "required": [
    "vpc",
    "vm",
    "to"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The account's firewalls with their inbound rules and the machines they protect, plus the quota. Scope: vms.read.

{
  "type": "object",
  "properties": {}
}

One firewall: its rules and the machines it protects, with the status of each (applied, pending, error). Scope: vms.read.

{
  "type": "object",
  "properties": {
    "firewall": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Firewall id, as returned by list_firewalls or create_firewall."
    }
  },
  "required": [
    "firewall"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a reusable set of inbound and outbound rules. Without rules it starts with SSH (TCP 22) and ping open from anywhere; pass rules: [] for none. Nothing is filtered until it is attached to a machine. Scope: network.write.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "rules": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "direction": {
            "description": "in (default) lets traffic in; out lets it out. The first outbound rule makes outbound restrictive.",
            "type": "string",
            "enum": [
              "in",
              "out"
            ]
          },
          "protocol": {
            "type": "string",
            "enum": [
              "tcp",
              "udp",
              "icmp",
              "any"
            ],
            "description": "icmp covers ping for IPv4 and IPv6; any is every protocol."
          },
          "ports": {
            "description": "TCP/UDP only: \"22\", \"80,443\" or a range \"8000-8100\" (up to 15 items). Omitted or null: all ports.",
            "type": [
              "string",
              "null"
            ]
          },
          "sources": {
            "description": "Inbound rules only: IPv4/IPv6 addresses or ranges allowed in. Omitted or empty: anywhere.",
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "destinations": {
            "description": "Outbound rules only: IPv4/IPv6 addresses or ranges allowed out to. Omitted or empty: anywhere.",
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "protocol"
        ]
      }
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rules REPLACES the whole list and is applied at once to every attached machine: send every rule to keep, not only the new one (read get_firewall first). Removing the SSH rule can lock the agent out. pending_machines counts machines not updated yet, retried automatically. Scope: network.write.

{
  "type": "object",
  "properties": {
    "firewall": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Firewall id, as returned by list_firewalls or create_firewall."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "rules": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "direction": {
            "description": "in (default) lets traffic in; out lets it out. The first outbound rule makes outbound restrictive.",
            "type": "string",
            "enum": [
              "in",
              "out"
            ]
          },
          "protocol": {
            "type": "string",
            "enum": [
              "tcp",
              "udp",
              "icmp",
              "any"
            ],
            "description": "icmp covers ping for IPv4 and IPv6; any is every protocol."
          },
          "ports": {
            "description": "TCP/UDP only: \"22\", \"80,443\" or a range \"8000-8100\" (up to 15 items). Omitted or null: all ports.",
            "type": [
              "string",
              "null"
            ]
          },
          "sources": {
            "description": "Inbound rules only: IPv4/IPv6 addresses or ranges allowed in. Omitted or empty: anywhere.",
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "destinations": {
            "description": "Outbound rules only: IPv4/IPv6 addresses or ranges allowed out to. Omitted or empty: anywhere.",
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "protocol"
        ]
      }
    }
  },
  "required": [
    "firewall"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Deletes a firewall attached to no machine. Refused while it protects one: detach it first. Scope: network.write.

{
  "type": "object",
  "properties": {
    "firewall": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Firewall id, as returned by list_firewalls or create_firewall."
    }
  },
  "required": [
    "firewall"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

From now on the machine refuses inbound traffic no rule of its firewalls opens; enforced within about ten seconds of the call. Up to 5 firewalls per machine, rules add up. Refused for a machine with no public address. Attaching again is harmless. Scope: network.write.

{
  "type": "object",
  "properties": {
    "firewall": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Firewall id, as returned by list_firewalls or create_firewall."
    },
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    }
  },
  "required": [
    "firewall",
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Removes the firewall's rules from the machine; with no other firewall it accepts all inbound traffic again. Scope: network.write.

{
  "type": "object",
  "properties": {
    "firewall": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Firewall id, as returned by list_firewalls or create_firewall."
    },
    "vm": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Machine id, as returned by list_vms or create_vm."
    }
  },
  "required": [
    "firewall",
    "vm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The account's load balancers with their addresses, pools, targets and health, listeners and rules, certificates; plus the quota. Scope: vms.read.

{
  "type": "object",
  "properties": {}
}

One load balancer in full: status, ipv4/ipv6 to put in DNS, pools with targets (health, sessions, response time), listeners with rules in evaluation order, certificates. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    }
  },
  "required": [
    "lb"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Requests by response class, connections, bytes in/out and peak sessions over 1h (1-minute buckets), 24h (15 minutes) or 7d (1 hour), plus totals. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "range": {
      "type": "string",
      "enum": [
        "1h",
        "24h",
        "7d"
      ]
    }
  },
  "required": [
    "lb"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Orders a load balancer in a private network, billed by the hour from now (the account needs 24 hours of credit), or by the month (7.30 CAD) or the year (73 CAD) with billing. A monthly or yearly period comes out of credit if it covers it; otherwise billing.pending_invoice holds the invoice to pay and it stays hourly until then. Ready within minutes (status pending → active); pools and listeners can be added meanwhile. Retrying the same call is safe. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Private network whose machines will be the targets (list_vpcs)."
    },
    "billing": {
      "description": "hourly (default), monthly (the price of 730 hours, paid in advance) or yearly (ten months). Ask the user; monthly or yearly needs credit or an invoice paid by the user.",
      "type": "string",
      "enum": [
        "hourly",
        "monthly",
        "yearly"
      ]
    },
    "idempotency_key": {
      "description": "Your own unique value per order. By default one is derived from the call.",
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "name",
    "vpc"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Deletes the load balancer, its address and its configuration; billing stops. Target machines are not touched. Ask the user first. Scope: vms.destroy.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    }
  },
  "required": [
    "lb"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Without pool: creates one (name required, up to 10). With pool: changes only the fields given. Deleting a pool also removes its targets and the rules leading to it. Scope: network.write.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "pool": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Pool id, from get_load_balancer."
    },
    "name": {
      "description": "Letters, digits, spaces, . _ -; unique in the load balancer.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "protocol": {
      "description": "http pools serve http/https listeners, tcp pools tcp listeners. Default http; cannot change once in use.",
      "type": "string",
      "enum": [
        "http",
        "tcp"
      ]
    },
    "algorithm": {
      "type": "string",
      "enum": [
        "roundrobin",
        "leastconn"
      ]
    },
    "health_type": {
      "description": "http (http pools only): GET health_path, 2xx or 3xx is healthy. Default tcp.",
      "type": "string",
      "enum": [
        "tcp",
        "http"
      ]
    },
    "health_path": {
      "description": "e.g. /health",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 128
        },
        {
          "type": "null"
        }
      ]
    },
    "health_interval": {
      "description": "Seconds between checks, default 5.",
      "type": "integer",
      "minimum": 2,
      "maximum": 60
    },
    "send_proxy": {
      "description": "tcp pools only: PROXY protocol v2 to the targets.",
      "type": "boolean"
    }
  },
  "required": [
    "lb"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Removes a pool, its targets and the rules leading to it. Scope: network.write.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "pool": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Pool id, from get_load_balancer."
    }
  },
  "required": [
    "lb",
    "pool"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

REPLACES the pool's targets with exactly this list (up to 25): send every target to keep. Each machine must be in the load balancer's private network (connect_vpc first). drain: true stops new connections to a target before maintenance. Scope: network.write.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "pool": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Pool id, from get_load_balancer."
    },
    "targets": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "vm": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Machine id, as returned by list_vms or create_vm."
          },
          "port": {
            "type": "integer",
            "minimum": 1,
            "maximum": 65535,
            "description": "Port the service listens on, on the machine's private address."
          },
          "weight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 256
          },
          "drain": {
            "type": "boolean"
          }
        },
        "required": [
          "vm",
          "port"
        ]
      }
    }
  },
  "required": [
    "lb",
    "pool",
    "targets"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

An entry port on the load balancer's address. Without listener: opens one (port and protocol required, up to 5; 22 and 8402 are reserved). https gets certificates for its rules' hostnames; redirect_https makes port 80 redirect to it. A tcp listener needs a tcp default_pool. sources restricts who may connect (null: everyone); with an https listener, port 80 stays open to everyone. Scope: network.write.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "listener": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listener id, from get_load_balancer."
    },
    "port": {
      "type": "integer",
      "minimum": 1,
      "maximum": 65535
    },
    "protocol": {
      "type": "string",
      "enum": [
        "http",
        "https",
        "tcp"
      ]
    },
    "default_pool": {
      "description": "Pool for traffic no rule matches; none answers 503.",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "redirect_https": {
      "type": "boolean"
    },
    "sources": {
      "description": "IPv4/IPv6 addresses or ranges allowed in.",
      "anyOf": [
        {
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "lb"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Closes the port and removes its rules. Scope: network.write.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "listener": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listener id, from get_load_balancer."
    }
  },
  "required": [
    "lb",
    "listener"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

REPLACES the http/https listener's rules: each sends a hostname and/or path prefix to an http pool (up to 25). They are evaluated most specific first, whatever the order sent; anything unmatched goes to the default pool. No wildcard hostname on https. Each https hostname gets a certificate once it points to the load balancer. Scope: network.write.

{
  "type": "object",
  "properties": {
    "lb": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Load balancer id, as returned by list_load_balancers or create_load_balancer."
    },
    "listener": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listener id, from get_load_balancer."
    },
    "rules": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hostname": {
            "description": "e.g. app.example.com, or *.example.com on http only.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 253
              },
              {
                "type": "null"
              }
            ]
          },
          "path_prefix": {
            "description": "e.g. /api/",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 128
              },
              {
                "type": "null"
              }
            ]
          },
          "pool": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Pool id, from get_load_balancer."
          }
        },
        "required": [
          "pool"
        ]
      }
    }
  },
  "required": [
    "lb",
    "listener",
    "rules"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The account's managed databases with their status, private and public addresses, disk, backups and billing (no passwords), plus the quota. Scope: vms.read.

{
  "type": "object",
  "properties": {}
}

What can be ordered: engines and versions, extensions, sizes with their hourly, monthly and yearly prices per region, and the price of disk beyond what a size includes. Call it before create_database and show the price to the user. Scope: vms.read.

{
  "type": "object",
  "properties": {}
}

One database: status, connection (host, private ip, port, defaultdb and ffxfadmin; on Valkey no database and default), public access and sources, disk usage and cap, users with their databases (null: all) and read_only, logical databases and extensions, Valkey's eviction policy and data memory, backups and restore window, maintenance window, fork link, warning. No passwords. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every user with its password, databases and read_only, and its own connection_uri; ready-made connection strings for the admin (private network, and public when open). Treat the result as a secret: give it to the application through an environment variable or a secret store, never into code, commits or logs. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CPU, memory, connections and commits per minute (commands per minute on Valkey) over 1h (1-minute buckets), 24h (10 minutes) or 7d (1 hour); only buckets with samples. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "range": {
      "type": "string",
      "enum": [
        "1h",
        "24h",
        "7d"
      ]
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The 20 queries with the most total time (pg_stat_statements, values replaced by $1, $2…; performance_schema on MySQL and MariaDB, values replaced by ?): calls, total and mean time, rows. A starting point for indexes. On Valkey, the commands with the most total time since the engine started (GET, HSET…). Scope: vms.read.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Completed backups (weekly full, daily differential; the transaction log is archived continuously) and the restore window: any minute in it can be restored with restore_database. On Valkey, snapshots (rdb) every hour when there were writes, all kept 24 hours, then one a day. Scope: vms.read.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Orders a managed database (PostgreSQL, MySQL, MariaDB or Valkey) in a private network, billed by the hour from now (the account needs 24 hours of credit), or by the month (730 hours) or the year (ten months) with billing; get_database_options gives each price. A monthly or yearly period comes out of credit if it covers it; otherwise billing.pending_invoice holds the invoice to pay and it stays hourly until then. Ready within minutes (status pending → active), with the admin user ffxfadmin and the logical database defaultdb (Valkey: the admin default, no logical database). Retrying the same call is safe. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "vpc": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Private network the database joins (list_vpcs); the machines on it reach the database."
    },
    "engine": {
      "description": "Default postgresql. mysql is Percona Server; valkey is Redis-compatible (key-value, in memory).",
      "type": "string",
      "enum": [
        "postgresql",
        "mysql",
        "mariadb",
        "valkey"
      ]
    },
    "version": {
      "description": "Major version from get_database_options; the newest by default.",
      "type": "string"
    },
    "size_gb": {
      "description": "Memory in GB, one of the sizes of get_database_options for the region. Default: 1, or the source's size.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "billing": {
      "description": "hourly (default), monthly (the price of 730 hours, paid in advance) or yearly (ten months). Ask the user; monthly or yearly needs credit or an invoice paid by the user.",
      "type": "string",
      "enum": [
        "hourly",
        "monthly",
        "yearly"
      ]
    },
    "idempotency_key": {
      "description": "Your own unique value per order. By default one is derived from the call.",
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "name",
    "vpc"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a NEW database, billed like any other, holding the data as it was at a given minute of the source's restore window (list_database_backups; Valkey: the last snapshot before that minute), with the same users and passwords. The source is not touched and may have been deleted in the last 7 days. Retrying the same call is safe. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The source database."
    },
    "at": {
      "type": "string",
      "description": "ISO 8601 timestamp, UTC unless an offset is given, e.g. 2026-10-14T09:30:00Z."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Name of the new database."
    },
    "vpc": {
      "description": "Default: the source's private network.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "size_gb": {
      "description": "Memory in GB, one of the sizes of get_database_options for the region. Default: 1, or the source's size.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "database",
    "at",
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a NEW database, billed like any other, whose data is an instant copy of this one (for a test or staging copy), with the same users and passwords. It stays linked to its source for up to 7 days (no backups of its own, the source cannot be deleted) unless detach_database_fork ends that sooner. Retrying the same call is safe. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The source database."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Name of the new database."
    },
    "vpc": {
      "description": "Default: the source's private network; same region either way.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "size_gb": {
      "description": "Memory in GB, one of the sizes of get_database_options for the region. Default: 1, or the source's size.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "database",
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Gives a linked fork its own copy of the data; the database is unavailable for about 30 seconds, then its backups start. Scope: vms.action.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Moves the database to a LARGER size (more vCPU, memory and included disk; see get_database_options): same data, users, names and addresses. It restarts: one to two minutes of downtime, status maintenance meanwhile (resize.to_gb set), then active with the new size_gb. The new rate applies from the next hour. Larger sizes only, there is no way back: tell the user the new price and the downtime first. Retrying the same call is safe. Scope: vms.create.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "size_gb": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1024,
      "description": "Memory in GB, larger than the current size_gb."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "database",
    "size_gb"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

DELETES the database and its data; billing stops. Ask the user first. confirm_name must be the database's exact name. Its backups stay 7 days (restore_database can bring it back meanwhile). Refused while a linked fork depends on it. Scope: vms.destroy.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "confirm_name": {
      "type": "string",
      "description": "The database's exact name, typed back as confirmation."
    }
  },
  "required": [
    "database",
    "confirm_name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Any of: the name; the weekly maintenance window (day 0 = Sunday, start hour, Montréal time, 2 hours long; minor updates, usually under 2 minutes of downtime); the disk cap (the disk grows by itself at 80 % full, up to the cap; disk beyond what the size includes is billed per GB); on Valkey, the eviction policy. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "maintenance_day": {
      "type": "integer",
      "minimum": 0,
      "maximum": 6
    },
    "maintenance_hour": {
      "type": "integer",
      "minimum": 0,
      "maximum": 23
    },
    "disk_cap_gb": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "eviction_policy": {
      "description": "Valkey only: what happens when data memory is full. noeviction (default) refuses writes; allkeys-lru removes the least used keys, for a cache.",
      "type": "string",
      "enum": [
        "noeviction",
        "allkeys-lru",
        "allkeys-lfu",
        "allkeys-random",
        "volatile-lru",
        "volatile-lfu",
        "volatile-random",
        "volatile-ttl"
      ]
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Opens the database to the internet at its public host and port (IPv4 and IPv6, TLS and password still required), or closes it. sources restricts who may connect (IPv4/IPv6 addresses or ranges); omitted it is left as is, null or [] means everyone. Prefer listing the user's addresses. Live within about 30 seconds. Scope: network.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "enabled": {
      "type": "boolean"
    },
    "sources": {
      "anyOf": [
        {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "database",
    "enabled"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Starts a differential backup within a minute, e.g. before a risky migration. Not available on a linked fork. Scope: backups.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    }
  },
  "required": [
    "database"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a user with a generated password, returned here once (also readable with get_database_credentials); live within seconds. Up to 30 users. It connects only to its databases (every logical database, future ones included, when databases is omitted): it reads and writes everything there and creates tables (on PostgreSQL in public too), or only reads with read_only; elsewhere it has no access. Its connection_uri points to defaultdb, or to its first database without access to defaultdb. On Valkey, an ACL user with every key and data command (no databases, no read_only). Treat the password as a secret. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "username": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "Lowercase letters, digits and _, starting with a letter or _."
    },
    "databases": {
      "description": "Logical databases it may connect to (existing ones, see get_database). Omit for all of them, future ones included.",
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z_][a-z0-9_]{0,62}$",
        "description": "Lowercase letters, digits and _, starting with a letter or _."
      }
    },
    "read_only": {
      "description": "SELECT only (MySQL, MariaDB: SELECT and SHOW VIEW). Default false.",
      "type": "boolean"
    }
  },
  "required": [
    "database",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sets the logical databases a user connects to (databases: a list, or null for all of them, future ones included) and whether it only reads; a field left out keeps its value. Applied within seconds; where its access is removed or lowered, its open connections are closed, so tell the user first if an application uses it. Not on the admin (it always has every database) nor on Valkey. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "username": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "Lowercase letters, digits and _, starting with a letter or _."
    },
    "databases": {
      "description": "Logical databases it may connect to; null for all of them, future ones included.",
      "anyOf": [
        {
          "maxItems": 30,
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[a-z_][a-z0-9_]{0,62}$",
            "description": "Lowercase letters, digits and _, starting with a letter or _."
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "read_only": {
      "type": "boolean"
    }
  },
  "required": [
    "database",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Gives the user a new password, returned here; the old one stops working within seconds, so update the application first or right after. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "username": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "Lowercase letters, digits and _, starting with a letter or _."
    }
  },
  "required": [
    "database",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Hands the user's objects to the admin, then drops the user. The admin (ffxfadmin, or default on Valkey) cannot be deleted. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "username": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "Lowercase letters, digits and _, starting with a letter or _."
    }
  },
  "required": [
    "database",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates another database inside the managed database (like defaultdb), owned by the admin; up to 30. Not on Valkey (numbered databases, SELECT 0 to 15). Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "name": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "Lowercase letters, digits and _, starting with a letter or _."
    }
  },
  "required": [
    "database",
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

DROPS the logical database with everything in it (the backups keep it 7 days). Ask the user first. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "name": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "Lowercase letters, digits and _, starting with a letter or _."
    }
  },
  "required": [
    "database",
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

PostgreSQL only. Enables an extension from get_database_options (vector for pgvector, postgis, pg_trgm…) in one logical database; installed on demand, live within a minute. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "name": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "The logical database, e.g. defaultdb."
    },
    "extension": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "required": [
    "database",
    "name",
    "extension"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Drops the extension without CASCADE: if objects depend on it, it stays and get_database shows why in warning. Scope: databases.write.

{
  "type": "object",
  "properties": {
    "database": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Database id, as returned by list_databases or create_database."
    },
    "name": {
      "type": "string",
      "pattern": "^[a-z_][a-z0-9_]{0,62}$",
      "description": "The logical database."
    },
    "extension": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "required": [
    "database",
    "name",
    "extension"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The runs-on labels with their vCPU, memory and price per minute, the account's concurrency (vCPU of jobs starting or running, and the cap), the linked GitHub organizations and accounts, this month's minutes and cost per repository, the actions cache next to the runners (bytes, entries and last use per repository, price per GB per month), and the Docker cache per repository (enabled in the console, bytes, last successful job). Scope: billing.read.

{
  "type": "object",
  "properties": {}
}

Jobs that ran or wait on FFxF runners, most recent first: repository, workflow and job, label, status (queued with waiting_reason credit, budget or account; running; succeeded; failed, stopped_for_credit when the credit ran out; cancelled; refused with refusal), times, billed minutes and amount, link to the run. Scope: billing.read.

{
  "type": "object",
  "properties": {
    "repository": {
      "description": "owner/name",
      "type": "string",
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "cancelled",
        "refused"
      ]
    },
    "limit": {
      "description": "Default 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "meta.next_cursor of the previous page.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

SSH keys saved on the account, to pass to create_vm. Scope: sshkeys.write or vms.read.

{
  "type": "object",
  "properties": {}
}

Saves a public key on the account so new machines can be reached without a password. Scope: sshkeys.write.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 64
    },
    "public_key": {
      "type": "string",
      "maxLength": 8192,
      "description": "OpenSSH public key, e.g. ssh-ed25519 AAAA… user@host."
    }
  },
  "required": [
    "name",
    "public_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Removes a key from the account. Machines already deployed with it keep it; only future deployments change. Scope: sshkeys.write.

{
  "type": "object",
  "properties": {
    "key": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "minLength": 1
        }
      ],
      "description": "Key id from list_ssh_keys."
    }
  },
  "required": [
    "key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}