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

# endstate.settings.update

> Sets the org-wide default tap redirect URL. Send null to clear. Network settings are read-only and returned for reference.

```ts theme={null}
update(body: UpdateSettingsRequest, options?: RequestOptions): Promise<SettingsResponse>
```

|             |                                                                     |
| ----------- | ------------------------------------------------------------------- |
| Endpoint    | [`PATCH /v1/settings`](/api-reference/settings/update-org-settings) |
| Credential  | Secret key (`end_sk_...`)                                           |
| Retry class | `write`                                                             |

Never repeated. The API accepts no idempotency key here, so a second send is a second write. Only `429 rate_limit.exceeded` is retried.

## Example

```ts theme={null}
const result = await endstate.settings.update({
  default_redirect_url: "https://brand.example",
});
```

## Parameters

<ParamField body="default_redirect_url" type="string | null" required>
  Org-wide default tap redirect URL, used only when no unit, product, or collection redirect applies. Send null to clear.
</ParamField>

## Returns

`200` - `SettingsResponse`.

<ResponseField name="default_redirect_url" type="string | null" required>
  Org-wide default tap redirect URL, used only when no unit, product, or collection redirect applies.
</ResponseField>

<ResponseField name="default_chain_id" type="integer | null" required>
  Identifier of your organization's default network - the network collections are created on when `chain_id` is omitted. `null` when no default network is configured for your organization. Read-only; configured by Endstate.
</ResponseField>

<ResponseField name="allowed_chain_ids" type="integer[]" required>
  Network identifiers enabled for your organization. An explicit `chain_id` on collection create must be one of these values. Read-only; configured by Endstate.
</ResponseField>

## Errors

Branch on `error.code`, never on the HTTP status - several codes share one.

| Code                | HTTP | Retry         |
| ------------------- | ---- | ------------- |
| `auth.unauthorized` | 401  | Do not retry  |
| `internal.error`    | 500  | Safe to retry |
| `validation.failed` | 400  | Do not retry  |

See [Errors and retries](/sdks/core/errors-and-retries) for the error types and how to narrow them.