Foxx Service configuration / dependencies
This is an introduction to ArangoDB’s HTTP interface for managing Foxx services configuration and dependencies.
Get configuration options
get configuration options
GET /_api/foxx/configuration
Query Parameters
- mount (string, required): Mount path of the installed service.
Fetches the current configuration for the service at the given mount path.
Returns an object mapping the configuration option names to their definitions including a human-friendly title and the current value (if any).
Responses
HTTP 200: Returned if the request was successful.
Update configuration options
update configuration options
PATCH /_api/foxx/configuration
Query Parameters
- mount (string, required): Mount path of the installed service.
Request Body
(json, required)
A JSON object mapping configuration option names to their new values. Any omitted options will be ignored.
Replaces the given service’s configuration.
Returns an object mapping all configuration option names to their new values.
Responses
HTTP 200: Returned if the request was successful.
Replace configuration options
replace configuration options
PUT /_api/foxx/configuration
Query Parameters
- mount (string, required): Mount path of the installed service.
Request Body
(json, required)
A JSON object mapping configuration option names to their new values. Any omitted options will be reset to their default values or marked as unconfigured.
Replaces the given service’s configuration completely.
Returns an object mapping all configuration option names to their new values.
Responses
HTTP 200: Returned if the request was successful.
Get dependency options
get dependency options
GET /_api/foxx/dependencies
Query Parameters
- mount (string, required): Mount path of the installed service.
Fetches the current dependencies for service at the given mount path.
Returns an object mapping the dependency names to their definitions including a human-friendly title and the current mount path (if any).
Responses
HTTP 200: Returned if the request was successful.
Update dependencies options
update dependencies options
PATCH /_api/foxx/dependencies
Query Parameters
- mount (string, required): Mount path of the installed service.
Request Body
(json, required)
A JSON object mapping dependency names to their new mount paths. Any omitted dependencies will be ignored.
Replaces the given service’s dependencies.
Returns an object mapping all dependency names to their new mount paths.
Responses
HTTP 200: Returned if the request was successful.
Replace dependencies options
replace dependencies options
PUT /_api/foxx/dependencies
Query Parameters
- mount (string, required): Mount path of the installed service.
Request Body
(json, required)
A JSON object mapping dependency names to their new mount paths. Any omitted dependencies will be disabled.
Replaces the given service’s dependencies completely.
Returns an object mapping all dependency names to their new mount paths.
Responses
HTTP 200: Returned if the request was successful.