Skip to main content
POST
Update Check Settings
Use this API to update a project’s checks settings: the confidence floor, your own flags and the default owners. A field set to null is cleared. A field left out is kept. The response is the settings the engine now applies, as Get Check Settings returns them.

Endpoint

POST https://api.velt.dev/v2/agents/checks/settings/update

Headers

string
required
Your API key.
string
required

Body

Params

object
required
The schema uses .strict(): unknown fields, in data, settings, owners or an owner, are rejected.

Example Requests

1. Raise the floor and set the dev owner

2. Set a flag and clear the floor

Response

Success Response

See Get Check Settings for the fields.

Failure Response

Errors: INVALID_ARGUMENT (a body outside the schema: a missing settings, a confidenceFloor outside 0..100, a flag that is not a boolean or null, an owner without userId, or an unknown field) / NOT_FOUND with CHECKS_WORKSPACE_NOT_FOUND (the workspace has no store database).