---
title: "Update a sponsor configuration"
method: PUT
path: "/v1/domains/{domainId}/account/{accountId}/sponsor"
tags: ["Gas station"]
---

# Update a sponsor configuration

`PUT /v1/domains/{domainId}/account/{accountId}/sponsor`

## Request

- Base URL: `https://docs.ripple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.ripple.com/v1/domains/{domainId}/account/{accountId}/sponsor`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ripple/apis/ripple-custody-api/docs/v1/domains/:domainId/account/:accountId/sponsor/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `domainId` string, required
- `accountId` string, required

## Request body

- GasStationUpdateSponsorDto
  - `type` 'domain' | 'account' | 'none', required: Type of sponsorship
  - `accountIds` string[]: Array of account UUIDs to sponsor
  - `includeSubDomains` boolean, required: Include subdomains in sponsorship
  - `alertLimit` GasStationAlertLimitDto[], required: Alert thresholds per ticker
    - `tickerId` string, required: Ticker/token UUID
    - `amount` string, required: Alert threshold amount
  - `userId` string: UUID of the user performing the action; recorded on the audit trail. Optional — only honored when the caller is a service principal; otherwise the authenticated user from the JWT is used.

## Response `200`

Sponsor updated

- GasStationSponsorResponseDto
  - `type` string, required
  - `accountIds` string[], required
  - `includeSubDomains` boolean, required
  - `alertLimit` GasStationAlertLimitDto[], required
    - `tickerId` string, required: Ticker/token UUID
    - `amount` string, required: Alert threshold amount
  - `balanceStatus` GasStationBalanceStatusDto[]: Balance status per configured alert. Omitted if balance fetch fails.
    - `tickerId` string, required: Ticker UUID
    - `tickerSymbol` string, required: Ticker symbol for display (e.g., SOL, ETH, XRP)
    - `threshold` string, required: Configured alert threshold amount
    - `currentBalance` string, required: Current balance from Core
    - `status` 'healthy' | 'critical', required: Balance status: critical if currentBalance <= threshold
  - `criticalCount` number: Number of tickers in critical status. Omitted if balance fetch fails.

## Other responses

- `400`: Bad request
- `404`: Sponsor not found

---

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