Request Dedicated IP

Submit a new dedicated-IP allocation request. The request enters a pending queue and is fulfilled by an admin: for a single request the admin picks one pool IP; for a per_region request the admin auto-assigns one IP per requested region (no manual pick).

Two modes — choose with selection_mode:

• single (default): one IP in one region. Attached endpoints get a plain DNS A-record at the endpoint hostname. Pass region_slug.
• per_region: a group of one IP per region, geo-routed via GeoDNS behind a single CNAME — visitors resolve to the nearest regional IP. Pass regions (at least 2 distinct active regions). On approval this creates a per-region group you attach via POST /v1/endpoints/{uuid}/dedicated-ip-group.

Account scope: the IP(s) are allocated to your active account and billed at the account level. Use switch account to request for a different account.

Prerequisites:

• Plan must include the dedicated_ips entitlement.
• The dedicated-ip add-on must be enabled platform-wide.
• A valid payment method must be on file (returns 402 otherwise).
• An active subscription must exist (no free-tier dedicated IPs).

Maximum 6 active dedicated IPs per account (platform constant); for per_region the existing count plus the number of requested regions must not exceed that cap. Pending requests are deduplicated per account: a second single request for the same region (or a second open per_region request) before the first one resolves returns 409.

Setup fee: beyond the recurring per-IP charge, provisioning incurs a one-time, non-refundable setup fee set by the operator. The per_region setup fee is charged per region (× the number of regions). The fee is re-charged if a standby-parked IP is later reattached on a re-upgrade.

Request body

Response (201 Created)

The newly-created request. Initial status: "pending"; poll /requests until fulfilled. A per_region response additionally echoes selection_mode and the normalized regions array.

Errors