> ## Documentation Index
> Fetch the complete documentation index at: https://guides.affiliate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pool settings — get and update

> Retrieve or update the service and sync configuration for a pool.

## Get pool settings

**`GET /v1/pools/{id}/settings`**

### Path parameters

<ParamField path="id" type="string" required>
  ULID of the pool.
</ParamField>

### Response

`data.outclick_provider_order` is the pool's **outclick priority** list — the order a plain `outclick` link (no explicit `?format=`) tries its link providers, first to last; the first provider able to carry the click wins. Always the full candidate set (`network` plus every available link service, currently just `shopnomix`) — a provider never explicitly saved is appended in built-in order. The network link can always carry the click, so a provider ranked below it never gets a turn. Default order is `["network", "shopnomix"]`, meaning a plain outclick never routes through Shopnomix until a pool moves it above `network`.

***

## Update pool settings

**`PATCH /v1/pools/{id}/settings`**

### Path parameters

<ParamField path="id" type="string" required>
  ULID of the pool.
</ParamField>

### Body parameters

<ParamField body="offer_link_service" type="string">
  Link service to use for offer URLs.
</ParamField>

<ParamField body="link_service_key" type="string">
  API key for the configured link service.
</ParamField>

<ParamField body="default_url_format" type="string">
  Default URL format for product links (e.g. `"affiliate"`).
</ParamField>

<ParamField body="outclick_provider_order" type="string[]">
  The order a plain `outclick` link tries providers, first to last — `"network"` and `"shopnomix"` are the only values today. The first provider in the list able to carry the click wins; the network link always can, so ranking it first (the default) means a plain outclick never routes through Shopnomix. A provider left out of the list is appended after the ones you named, in built-in order; passing `[]` restores the built-in default order. Applies to new links immediately, and retroactively to `outclick` links already handed out (re-evaluated at click time).
</ParamField>

### Example request

```json theme={null}
{
  "offer_link_service": "skimlinks",
  "link_service_key": "your_link_service_key",
  "default_url_format": "affiliate",
  "outclick_provider_order": ["shopnomix", "network"]
}
```