Skip to main content
PATCH
Update gas station

Authorizations

X-API-Key
string
header
required

Headers

API-Version
enum<string>
default:v1

API version (defaults to the latest supported version if omitted).

Available options:
v1
Idempotency-Key
string

Unique key (1-255 printable ASCII chars) used to safely retry write operations. Same key + body returns the cached response; same key + different body returns 409.

Required string length: 1 - 255

Path Parameters

id
string<uuid>
required

Gas station ID

Body

application/json
auto_refill_enabled
boolean

Enable or disable auto-refill.

name
string

New name for the gas station.

Required string length: 2 - 100
Example:

"Ethereum gas station"

refill_amount
string

New per-refill amount (display unit).

Example:

"0.25"

threshold
string

New auto-refill threshold (display unit).

Example:

"0.05"

Response

Success

address
string

On-chain address holding the gas station's funds.

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

asset
string

Symbol of the asset the gas station holds (the chain's native coin).

Example:

"ETH"

asset_decimals
integer

Number of decimals used to convert the balance's base units to the display unit.

Example:

18

auto_refill_enabled
boolean

Whether the gas station auto-refills when it drops below the threshold.

Example:

true

balance
string

Current native-asset balance as an integer in the asset's smallest base unit.

Example:

"125000000000000000"

chain
string

Blockchain the gas station funds fees on.

Example:

"ethereum"

created_at
string<date-time>

ISO-8601 time when the gas station was created.

Example:

"2026-05-16T10:30:00Z"

gas_strategy
string

Gas pricing strategy applied when sponsoring fees.

Example:

"standard"

health_status
string

Health derived from balance versus threshold: "healthy" when at/above the threshold, "low" when below it.

Example:

"healthy"

id
string

Unique identifier of the gas station.

Example:

"9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d"

name
string

Human-readable name of the gas station.

Example:

"Ethereum gas station"

network
string

Network the gas station operates on.

Example:

"mainnet"

object
string

Object type discriminator; always "gas_station".

Example:

"gas_station"

refill_amount
string

Per-refill amount as a display-unit decimal.

Example:

"0.25"

refill_amount_raw
string

Per-refill amount as an integer in the asset's smallest base unit.

Example:

"250000000000000000"

refill_from_wallet_id
string

Identifier of the wallet auto-refills are funded from.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

status
string

Current status of the gas station.

Example:

"active"

threshold
string

Auto-refill threshold as a human-readable decimal in the display unit.

Example:

"0.05"

threshold_raw
string

Auto-refill threshold as an integer in the asset's smallest base unit.

Example:

"50000000000000000"

updated_at
string<date-time>

ISO-8601 time when the gas station was last updated.

Example:

"2026-05-16T10:30:00Z"