Skip to main content

​
POST /webhooks/config-update

Receives a config update pushed from the dashboard and persists the change to the specified guild’s configuration.
This endpoint requires API key authentication only. OAuth Bearer tokens are not accepted. If you send an OAuth token, the request returns a 403 response.
Authentication: API key (x-api-secret header) required.

​
Request body

​
guildId
string
required
The target Discord guild ID.
​
path
string
required
Dot-notated config path to update (for example, ai.model or welcome.enabled).
​
value
any
required
The new value to set at the specified path.

​
Response

On success, returns the updated top-level config section.
​
(config section)
object
The updated config section corresponding to the top-level key of the path parameter.

​
Example

curl -X POST \
  -H "x-api-secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"guildId": "987654321098765432", "path": "ai.model", "value": "claude-3-5-sonnet"}' \
  https://volvox.bot/api/v1/webhooks/config-update

{
  "enabled": true,
  "model": "claude-3-5-sonnet",
  "apiKey": "[REDACTED]"
}

​
Error responses

StatusCause
400Missing guildId, path, or value; or the path points to a non-writable key
401Missing x-api-secret header
403Request used OAuth Bearer authentication instead of API key
500Config write failed

Build docs developers (and LLMs) love

Get started for freeTalk to us