Skip to main content
The workspace is the top-level tenant in Salty. Every record (people, companies, deals, …) and every API key belongs to exactly one workspace.

​
Endpoints

MethodPathPurpose
GET/workspaceCurrent workspace + plan + counts
GET/workspace/usageAPI calls in the last 24h + current-period totals
PATCH/workspaceUpdate name and hard_cap_api_calls

​
GET /workspace

curl $SALTY_API/workspace \
  -H "Authorization: Bearer $SALTY_API_KEY"

{
  "id": "7f4e5a82-d58d-4dfc-b23c-58586ff05253",
  "slug": "dev",
  "name": "Dev",
  "plan": "pro",
  "records_count": 0,
  "api_calls_used_this_period": 0,
  "hard_cap_api_calls": null,
  "created_at": "2026-05-24T02:02:09.393Z"
}

​
GET /workspace/usage

{
  "api_calls_used_this_period": 1247,
  "api_calls_last_24h": 312,
  "records_count": 542,
  "plan": "pro"
}

​
PATCH /workspace

Editable fields: name, hard_cap_api_calls (set to null to remove the cap). 
curl -X PATCH $SALTY_API/workspace \
  -H "Authorization: Bearer $SALTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Inc.","hard_cap_api_calls":50000}'
Things you can’t change via API: slug, plan, dodo_customer_id. Plan changes go through the billing UI.