Tools Configuration API — Manage BugViper Linter Settings

These endpoints let you programmatically read and update the linter tool configuration for your account. BugViper supports three static analysis tools — Ruff (Python), ESLint (JavaScript/TypeScript), and golangci-lint (Go) — each of which can be independently enabled or disabled and pointed at a specific config file in your repository.

GET /api/v1/tools/config

Returns the current linter tools configuration for the authenticated user. Use this endpoint to read the saved state before presenting an edit form. Authentication required: Yes

curl https://your-domain.com/api/v1/tools/config \
  -H "Authorization: Bearer <token>"

Response

Returns a tools configuration object with one key per supported tool.

ruff

object

Configuration for the Ruff Python linter.

Show Ruff fields

enabled

boolean

Whether Ruff is active. When false, Ruff is skipped during both lint and full review runs.

configFile

string | null

Path to the Ruff config file in your repository (e.g., pyproject.toml, ruff.toml, .ruff.toml), or null to use Ruff’s built-in defaults.

eslint

object

Configuration for the ESLint JavaScript/TypeScript linter.

Show ESLint fields

enabled

boolean

Whether ESLint is active.

configFile

string | null

Path to the ESLint config file (e.g., eslint.config.js, .eslintrc, .eslintrc.json), or null to use ESLint’s automatic config resolution.

golangci_lint

object

Configuration for the golangci-lint Go linter.

Show golangci-lint fields

enabled

boolean

Whether golangci-lint is active.

configFile

string | null

Path to the golangci-lint config file (e.g., .golangci.yml, .golangci.yaml, .golangci.toml), or null to use golangci-lint’s defaults.

PUT /api/v1/tools/config

Saves an updated linter tools configuration. The full configuration object must be provided in the request body — partial updates are not supported. Changes take effect on the next review run immediately. Authentication required: Yes

Request Body

ruff.enabled

boolean

required

Set to true to enable Ruff, or false to disable it.

ruff.configFile

string | null

required

Path to the Ruff config file in your repository, or null to use Ruff’s built-in defaults.

eslint.enabled

boolean

required

Set to true to enable ESLint, or false to disable it.

eslint.configFile

string | null

required

Path to the ESLint config file in your repository, or null to use ESLint’s automatic config resolution.

golangci_lint.enabled

boolean

required

Set to true to enable golangci-lint, or false to disable it.

golangci_lint.configFile

string | null

required

Path to the golangci-lint config file in your repository, or null to use golangci-lint’s defaults.

curl -X PUT https://your-domain.com/api/v1/tools/config \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ruff": { "enabled": true, "configFile": null },
    "eslint": { "enabled": true, "configFile": ".eslintrc.json" },
    "golangci_lint": { "enabled": false, "configFile": null }
  }'

Response

Returns the updated tools configuration object in the same shape as the GET /api/v1/tools/config response.

Disabling a tool does not delete its configFile setting. If you re-enable the tool later, the previously saved config file path will be restored automatically.

Overview

Endpoints

Tools Configuration API — Manage BugViper Linter Settings

GET /api/v1/tools/config

Response

PUT /api/v1/tools/config

Request Body

Response

​GET /api/v1/tools/config

​Response

​PUT /api/v1/tools/config

​Request Body

​Response

GET /api/v1/tools/config

Response

PUT /api/v1/tools/config

Request Body

Response