Skip to Content
Drip Docs
Guides

Choosing a workspace

List your workspaces, then pass workspace_id when you have more than one.

Start by listing your workspaces:

curl "https://api.joindrip.ai/v1/workspaces" \
  -H "Authorization: Bearer $DRIP_API_KEY"

Each workspace has an id, a name, and a type.

Tracking and updates

Pass the workspace id in the path:

curl "https://api.joindrip.ai/v1/workspaces/$WORKSPACE_ID/updates?since=7d" \
  -H "Authorization: Bearer $DRIP_API_KEY"

Search, stories, companies, and people

These calls take the workspace as workspace_id. If you have more than one workspace, you need to send it, even for a search across all of Drip:

curl "https://api.joindrip.ai/v1/search" \
  -H "Authorization: Bearer $DRIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"scope\":\"corpus\",\"query\":\"funding\",\"workspace_id\":$WORKSPACE_ID,\"limit\":1}"

If you leave it out, the call returns HTTP 400 with status set to choose_workspace, and the response lists your workspaces so you can pick one.

Search scope

A search's scope is corpus or workspace:

  • corpus, the default, searches everything in Drip.
  • workspace searches only the sources behind that workspace's updates.