---
title: "Add wallets to flag whitelist"
method: POST
path: "/admin/flags/{flag_key}/wallets"
tags: ["FeatureFlag"]
---

# Add wallets to flag whitelist

`POST /admin/flags/{flag_key}/wallets`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/flags/{flag_key}/wallets`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/flags/:flag_key/wallets/post.ts> (a function with typed inputs; its response is checked against the schema)

Add one or more wallets to a feature flag's whitelist. Returns breakdown of added / skipped (already present) / invalid (bad format).

## Path parameters

- `flag_key` string, required

## Request body

- FeatureFlagAdminServiceAddFlagWalletsBody
  - `wallets` string[]: Wallet addresses to add (hex with 0x prefix, case-insensitive).
  - `note` string: Free-form note attached to every wallet added in this call.
  - `actor` string: Wallet address of the admin performing this action. Required.

## Response `200`

A successful response.

- ApiAddFlagWalletsResponse
  - `added` string[]: Newly inserted wallets.
  - `skipped` string[]: Wallets already in the whitelist before this call (no-op).
  - `invalid` string[]: Wallets rejected for bad address format.
  - `total_added` integer: Count of wallets actually inserted.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/flags/:flag_key/wallets/post.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)