Skip to main content
GET
List workspaces

Authorizations

Authorization
string
header
required

An API key from your Devic console, sent as Authorization: Bearer <key>. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a 401. See Authentication.

Headers

X-Devic-User
string

Only with an API key: the userUID or email of a person of the key's account to act as, with that person's permissions. Without it, an API key acts as the account integration ("API"), which sees shared workspaces only. A person's token cannot name someone else.

Query Parameters

Words to look for

includeArchived
boolean

Include archived workspaces

withSummary
boolean

Add thread, unread and document counts

offset
integer
default:0

Items to skip

Required range: x >= 0
limit
integer
default:20

Items to return (at most 100)

Required range: 1 <= x <= 100

Response

Success — wrapped as { success: true, data }

success
boolean
Example:

true

data
object