← Back to Overview

SETTINGS & DATA

Settings

Configure API Studio — mode selection, SSL, cookies, tab layout, history limits, and notification preferences.

Accessing Settings

Settings are available in two places — both control the same underlying configuration:

Gear icon in webview top bar

Opens a popup menu with toggle switches. Faster for quick changes — SSL, cookies, mode toggles are one click away.

VS Code Settings → Extensions → API Studio

Standard VS Code settings UI. Best for JSON-level editing, workspace vs user scope, and settings sync.

Simple vs Advanced Mode

API Studio starts in Simple Mode by default for a clean, focused experience. Advanced Mode unlocks the full feature set.

Feature	Simple Mode	Advanced Mode
Top-level views	Requests only	Requests, Mock + MCP, Vault
Request tabs	Params, Headers, Body, Auth	All 8 tabs (+ Tests, Scripts, MCP, Settings)
Vault	Locked (if exists)	User-controlled

How to toggle: Settings gear → "Advanced Mode" checkbox. Requires a valid license to enable Advanced Mode.

Side effects when toggling to Simple Mode:

Current view forced to Requests

Vault is locked automatically

Active request tab reset to Params if on a hidden tab

SSL Verification

Controls whether API Studio verifies server TLS certificates before completing connections.

Default: enabled — verifies server certificates against the system trust store

Disable for self-signed certificates during development

Per-request — concurrent requests with different SSL settings don't interfere

VS Code setting: openPost.sslVerification

Note: This does NOT affect client certificates. Client certs for mTLS are configured separately via the Vault → Certificates section.

Cookies Enabled

Controls automatic cookie storage and sending.

Default: enabled — auto-stores Set-Cookie headers and sends matching cookies on subsequent requests

Disable to stop all cookie behavior — no storage, no sending

Cookie jar stored in .openpost/cookies.json

Cookie Manager accessible from the settings popup for viewing and clearing stored cookies

Tab Settings

Customize how request tabs appear and behave in the webview:

Setting	Default	Description
Collapsed Tabs	Off	Compact vertical tab list — stacked view for more screen space
Grouped Tabs	On	Group tabs by their source collection
Auto-hide Sidebar	Off	Hide VS Code native sidebar when the webview panel opens

Storage: All tab settings are stored in .openpost/config.json

Max History

Controls how many request history entries are kept before old ones are trimmed.

Default: 500 entries

Oldest entries are automatically trimmed on each new send when the cap is reached

Set higher for long-running projects with many endpoints

Set lower to save disk space

VS Code setting: openPost.maxHistory

Subtle Contracts

Controls how API Studio notifies you when a response returns a new JSON structure (contract variant).

Mode	Behavior
Off (default)	Shows a modal dialog — "Save Type" / "Skip" buttons interrupt your workflow
On	Shows a subtle inline indicator with a glow animation in the response status bar. Click to accept or dismiss.

Less intrusive for APIs with frequent response shape changes

Stored in .openpost/config.json

Proxy Configuration → Data Storage →