---
title: "Set the networks a business uses"
method: POST
path: "/identity/business/networks"
tags: ["identity", "networks", "customer-session"]
---

# Set the networks a business uses

`POST /identity/business/networks`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/identity/business/networks`
- Auth: none declared

Replaces the networks in use and the default network for every member and API key of the business. Requires `networks_manage` in enforced mode or `permissions_manage` in legacy mode. A change applies immediately, with no two-factor code; turning a network on grants no rail. Turning off a network that holds funds or has pending transactions is refused with network_holds_funds, and with network_holdings_unavailable when what it holds cannot be checked; a network the business is not eligible for with network_not_eligible, and an invalid set with invalid_networks. Saving what is already saved changes nothing and records nothing.

## Request body

- NetworksSetNetworksInput
  - `default_network` 'ethereum' | 'stellar' | 'solana', required
  - `enabled_networks` IdentityNetwork[], nullable, required: The networks to use. At least one, each listed once, each one the business is eligible for.

## Response `200`

OK

- NetworksOutput
  - `networks` NetworksNetworkItem[], nullable, required
    - `carries` NetworksCarriesView, required
      - `deposits` boolean, required: Whether USDC can be received on this network.
      - `funds` string[], nullable, required: Symbols of the funds that can be bought and sold with settlement on this network. BTC trades on no network and is never listed.
      - `withdrawals` boolean, required: Whether USDC can be sent on this network.
    - `chosen` boolean, required: Whether the business's saved choice includes this network, eligible or not.
    - `default` boolean, required: Whether this is the default network. At most one network is the default, and it is an enabled one.
    - `eligible` boolean, required: Whether the business may use this network at all, from the rollout settings. Turning a network on never grants a rail.
    - `enabled` boolean, required: Whether the business can use this network now: chosen and eligible.
    - `held` string[], nullable, required: The amounts held on this network, formatted for display, such as 10,000.00 USDC. Empty when none, and when holdings_unavailable.
    - `holdings_unavailable` boolean, required: True when what the network holds could not be read. Held and pending_transactions are then not an answer, and the network cannot be turned off.
    - `network` 'ethereum' | 'stellar' | 'solana', required
    - `pending_transactions` boolean, required: Whether a transaction is in flight on this network or a transfer approval for it is waiting.
    - `turn_off_blocked` string: Why this enabled network cannot be turned off, worded for the person who sees it. Absent when it can be, and for a network that is not enabled.
  - `writes_enabled` boolean, required: Whether this deployment accepts changes to the networks.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `default`: Error response.

## Changes

- **2026-10-29** `e003c8a67b62`: 4 info
  - added the optional property `error/authorization` to the response with the `400` status
  - added the optional property `error/authorization` to the response with the `401` status
  - added the optional property `error/authorization` to the response with the `403` status
  - added the optional property `error/authorization` to the response with the `default` status
- **2026-10-16** `96be8462f791`: 1 info
  - api tag `customer-session` added
- **2026-10-16** `2920950884e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/identity/business/networks/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/772c80d83658?raw)