---
title: "Opt in to auto-funding"
method: POST
path: "/api/gas-tank/v1/enterprises/{enterpriseId}"
tags: ["Gas Tanks"]
---

# Opt in to auto-funding

`POST /api/gas-tank/v1/enterprises/{enterpriseId}`

First-time-only enrollment into auto-funding. Creates one enrollment
row per coin with status `pending`; the background FeeWorker then
provisions thresholds and transitions each coin to `active`.
Once any enrollment exists for the enterprise this endpoint is closed —
subsequent per-coin changes must use
`PATCH /api/gas-tank/v1/enterprises/:enterpriseId/coin`.

## Path parameters

- `enterpriseId` string, required

## Request body

- object — Coins to enroll in auto-funding for the enterprise. Each coin must be supported and have a configured enterprise fee address.
  - `coins` string[], required

## Response `200`

OK

- object
  - `enrollments` object[], required
    - `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

- `403` — Forbidden
- `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/post.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/84c10109c46d?raw)