← All Docs

Configuration

Configure mTLS certificates, fallback mode, and spec format preferences for SpekAi.

VS Code Settings

SpekAi is configured through standard VS Code settings. Open Settings (Ctrl+, / Cmd+,) and search for SpekAi.

Fallback Mode

If you prefer manual validation, enable fallback mode:

{
  "spekai.enableFallback": true
}

This lets you make raw HTTP requests without AI assistance, which is handy for quick manual checks.

mTLS Client Certificates

SpekAi supports mutual TLS (mTLS) for APIs that require client certificate authentication. In the tester UI:

  1. Toggle the Client Certificate section
  2. Provide your certificate file (.pem or .crt)
  3. Provide your private key file
  4. Optionally add a CA certificate

All certificate paths are resolved relative to your workspace.

JSON vs YAML

SpekAi auto-detects the format of your spec file. Both OpenAPI 3.x (JSON and YAML) and Swagger 2.0 specs are supported. If loading from a URL, the Content-Type header is used for detection, with a fallback to file extension parsing.