DOCS
Reference

API: Workspace

Workspace: Get the workspace, Get usage, Get network settings, Set the browsing country.

Get the workspace

GET/api/v1/me

The workspace this key belongs to: its id, name and plan, and this period's usage.

MCP tool: get_workspace. Works with any key.

Returns { org: { id, name, plan }, keyId, usage }

Request
curl https://app.testsy.dev/api/v1/me \
  -H "Authorization: Bearer $QA_AI_API_KEY"

Get usage

GET/api/v1/usage

Plan, runs used this billing period, included runs, extra-run packs and runs left.

MCP tool: get_usage. Works with any key.

Returns { plan, period: { start, end }, runs, billable, active, appRuns, included, packs, packRuns, allowance, remaining, packRunsEach, packUsd, … }

Request
curl https://app.testsy.dev/api/v1/usage \
  -H "Authorization: Bearer $QA_AI_API_KEY"

Get network settings

GET/api/v1/network

How our browsers reach your sites: the static addresses to allow-list, the country they browse from, and the countries available.

MCP tool: get_network. Works with any key.

Returns { addresses: [ip], browseFrom: "auto" | country code, countries: [{ code, name }] }

Request
curl https://app.testsy.dev/api/v1/network \
  -H "Authorization: Bearer $QA_AI_API_KEY"

Set the browsing country

PATCH/api/v1/network

Choose the country our browsers visit your sites from (web tests), or automatic: the site's own country.

MCP tool: set_browse_from. Needs a key that can also create and edit tests.

Body (JSON)
countrystringrequired
Two-letter country code (see get_network), or "auto"

Returns { browseFrom }

Request
curl -X PATCH https://app.testsy.dev/api/v1/network \
  -H "Authorization: Bearer $QA_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"DE"}'