> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools/api-reference/settings-apis.md).

# Settings APIs

**Base URL:** `/api/v1/settings`

These endpoints allow retrieval and configuration of Guardian system settings, including Hedera operator credentials, environment information, and package version details.

**Authentication:** All endpoints require a valid JWT Bearer token (`Authorization: Bearer <token>`). Obtain a token via `POST /accounts/login`.

***

## Endpoints

| Method | Endpoint                | Description                                        | Auth Required |
| ------ | ----------------------- | -------------------------------------------------- | ------------- |
| POST   | `/settings`             | Set Guardian system settings                       | Yes           |
| GET    | `/settings`             | Return current Guardian system settings            | Yes           |
| GET    | `/settings/environment` | Return the current Hedera network environment name | Yes           |
| GET    | `/settings/about`       | Return Guardian package version information        | Yes           |

***

## Endpoint Details

* [Adding Settings](/developer-tools/api-reference/settings-apis/adding-settings.md)
* [Displaying Current Settings](/developer-tools/api-reference/settings-apis/displaying-current-settings.md)
* [Returns Environment Name](/developer-tools/api-reference/settings-apis/returns-environment-name.md)
* [Returns Package Version](/developer-tools/api-reference/settings-apis/returns-package-version.md)