banks2ff/firefly-iii-api/docs/ConfigurationApi.md
Jacob Kiers f0b8df90b9 Initial commit
This is definitely not functional yet.

Signed-off-by: Jacob Kiers <code@kiers.eu>
2024-10-04 20:31:39 +02:00

3.7 KiB

\ConfigurationApi

All URIs are relative to https://demo.firefly-iii.org/api

Method HTTP request Description
get_configuration GET /v1/configuration Get Firefly III system configuration values.
get_single_configuration GET /v1/configuration/{name} Get a single Firefly III system configuration value
set_configuration PUT /v1/configuration/{name} Update configuration value

get_configuration

Vecmodels::Configuration get_configuration(x_trace_id) Get Firefly III system configuration values.

Returns all editable and not-editable configuration values for this Firefly III installation

Parameters

Name Type Description Required Notes
x_trace_id Option<uuid::Uuid> Unique identifier associated with this request.

Return type

Vecmodels::Configuration

Authorization

firefly_iii_auth, local_bearer_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, application/x-www-form-urlencoded

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_single_configuration

models::ConfigurationSingle get_single_configuration(name, x_trace_id) Get a single Firefly III system configuration value

Returns one configuration variable for this Firefly III installation

Parameters

Name Type Description Required Notes
name ConfigValueFilter The name of the configuration value you want to know. [required]
x_trace_id Option<uuid::Uuid> Unique identifier associated with this request.

Return type

models::ConfigurationSingle

Authorization

firefly_iii_auth, local_bearer_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

set_configuration

models::ConfigurationSingle set_configuration(name, value, x_trace_id) Update configuration value

Set a single configuration value. Not all configuration values can be updated so the list of accepted configuration variables is small.

Parameters

Name Type Description Required Notes
name ConfigValueUpdateFilter The name of the configuration value you want to update. [required]
value models::PolymorphicProperty [required]
x_trace_id Option<uuid::Uuid> Unique identifier associated with this request.

Return type

models::ConfigurationSingle

Authorization

firefly_iii_auth, local_bearer_auth

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded, application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]