Skip to navigation
Get started

Workspaces and spaces

How Simplified scopes every request.
View as Markdown

Simplified is multi-tenant on two levels. A workspace is the billing and membership boundary. A space is a team area inside a workspace, used to separate clients, brands, or projects.

Scoping with an API key

An API key already carries its workspace, so most integrations send nothing extra:

curl https://api.simplified.com/api/v1/pm/boards \
  -H "Authorization: Api-Key $SIMPLIFIED_API_KEY"

To target a space with a workspace-scoped key, add the Space header:

curl https://api.simplified.com/api/v1/pm/boards \
  -H "Authorization: Api-Key $SIMPLIFIED_API_KEY" \
  -H "Space: 4821"

Discovering what you can reach

# the workspace behind the current credential
curl https://api.simplified.com/api/v1/workspaces/current \
  -H "Authorization: Api-Key $SIMPLIFIED_API_KEY"
# spaces you are a member of
curl https://api.simplified.com/api/v1/spaces/my \
  -H "Authorization: Api-Key $SIMPLIFIED_API_KEY"

Resources are filtered to the resolved workspace and space automatically. A resource belonging to another workspace returns 404, not 403 — existence is not disclosed across tenants.