ips

Reserve a dedicated outbound address: every sandbox of your organization sends from it.

For allow-lists at your database, API provider or firewall. One per address family; calling it again returns the one you have. No other organization sends from it while you hold it, or for 30 days after you release it. Needs credit on the account.

post/v1/ips

Request

  • Base URL: https://api.withruntime.com
  • URL: https://api.withruntime.com/v1/ips
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replaying the same key with the same request within 24 hours returns the first result and never repeats the effect. A refusal is not kept: a request refused before it ran (no_capacity, busy, a limit) runs afresh when sent again with its key. The SDKs send one automatically; the server makes one when absent and returns it in the idempotency-key response header.

Request body

familyinteger

4 (default) or 6.

Response

Success

fundedboolean

Funding permits traffic. False disables traffic while retaining the reservation; check balance, spending limits and account permissions.

fundedUntilstring date-time nullable

Last funded-through timestamp, possibly in the past. Null means no meter exists. Free IPv6 also receives renewable deadlines.

rateMicrosinteger

Immutable quoted monthly price in millionths of a US dollar.

rateUnit'unit_month'
idstring
addressstring

Every sandbox of the organization sends from it while funded.

familyinteger
createdAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.