> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/config.md).

# /api/v1/config

Administrators can define base configuration using this API. fylr has a basic set of configuration items which are in the core system, such as the name of the instance, administrator's main address, language definitions and so on.

Frontends are required to implement a generic form editor for base configuration items. The list of items can be retrieved using the [config/list](/for-developers/api/endpoints/config/list.md) API.

This list is not stable and can be changed without API change in any new version of fylr. Plugins can extend the list of configuration items. So, depending on the list of loaded plugins in fylr, the list has a various number of items.

### `GET /config` — Get all base configuration

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/config" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /config` — Write all base configuration

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/config" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /config/{path}` — Read a single base-config item or nested value

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/config/{path}" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /config/{path}` — Set a single base-config item or nested value

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/config/{path}" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `DELETE /config/{path}` — Remove a single base-config item or nested value

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/config/{path}" method="delete" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}