---
title: "Enable or disable coin auto-funding"
method: PATCH
path: "/api/gas-tank/v1/enterprises/{enterpriseId}/coin"
tags: ["Gas Tanks"]
---

# Enable or disable coin auto-funding

`PATCH /api/gas-tank/v1/enterprises/{enterpriseId}/coin`

Toggles auto-funding for a single coin in an opted-in enterprise.
`enable` upserts the enrollment with status `pending` (the FeeWorker
re-provisions thresholds and transitions it to `active`); `disable`
sets status `disabled` and the auto-funding cron skips the coin.
Requires an existing opt-in — call
`POST /api/gas-tank/v1/enterprises/{enterpriseId}` first.

## Path parameters

- `enterpriseId` string, required

## Request body

- object — Coin and action to enable or disable enterprise auto-funding. The action determines whether funding is enabled or disabled for the coin.
  - `coin` string, required — Coin to enable or disable
  - `action` 'enable' | 'disable', required — User intent. `enable` sets status `pending` (FeeWorker provisions thresholds and transitions to `active`). `disable` sets status `disabled`; the threshold is preserved but the funding cron skips the coin.

## Response `200`

OK

- object
  - `enrollment` EnrollmentResponse, required — Auto-funding enrollment state for one coin in an enterprise
    - `coin` string, required — Coin identifier
    - `status` 'pending' | 'active' | 'error' | 'disabled', required — Enrollment lifecycle state: pending = opted in, FeeWorker is provisioning thresholds. active = monitored and funded by the auto-funding cron. disabled = funding paused for this coin. error = provisioning failed; see lastError.
    - `version` number, required — Monotonic write counter for optimistic concurrency
    - `lastError` string, nullable, required — Populated only when status is error; null otherwise
    - `updatedAt` string, required — ISO 8601 timestamp of the last state change

## Other responses

- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity

## Changes

- **2026-09-17** `84c10109c46d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitgo/apis/bitgo-api/changes/api/gas-tank/v1/enterprises/:enterpriseId/coin/patch.md)

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/d083f3244790?raw)