Hunch

API Reference

Workspace & members

Read and rename the workspace, check credit usage and subscription status, and list team membership.

Get workspace

GET/workspace

Returns workspace details and your credit usage. plan_accounts is your limit, active_accounts is how many you're monitoring, and credits_remaining is the difference.

Response
{
  "data": {
    "id": "...",
    "name": "outwrite.ai",
    "plan_accounts": 800,
    "subscription_status": "active",
    "active_accounts": 214,
    "suggested_accounts": 356,
    "credits_remaining": 586,
    "created_at": "2026-05-01T..."
  }
}

Update workspace

PATCH/workspace

Updates workspace settings. Currently only the name is editable.

Body fields
namestringrequired

New workspace name.

Request
curl -X PATCH https://usehunch.co/api/v1/workspace \
  -H "Authorization: Bearer hunch_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme GTM" }'

Returns the updated workspace object, in the same shape as the read above.

List members

GET/members

Returns everyone in the workspace with their role.

Response
{
  "data": [
    {
      "user_id": "...",
      "display_name": "Aidan",
      "role": "owner",
      "created_at": "2026-05-01T..."
    }
  ]
}
PreviousSettings & integrationsNext API keys