Skip to main content
GET
Search threads across 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

workspaceId
string

Only this workspace

kind
enum<string>

direct: only private conversations; shared: only workspace threads. Default: both.

Available options:
direct,
shared

Words to look for

unread
boolean

Only unread threads

includeArchived
boolean

Include archived threads

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