Skip to main content
POST
Create a workspace

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
title
string
required

The display name of the workspace.

Example:

"Election coverage"

query
string
required

The boolean keyword query used to match mentions.

Example:

"(\"election integrity\" OR \"voter fraud\") AND 2026"

channels
enum<string>[]
required

One or more channels to monitor.

Minimum array length: 1
Available options:
news,
reddit,
telegram,
twitter,
youtube
Example:
folder
object

The folder to assign the workspace to.

Example:

Response

201 - application/json

The newly created workspace.

id
integer

The unique identifier for the workspace.

Required range: x >= 1
title
string

The user entered title of the workspace.

owner
string

The unique identifier of the user who owns the workspace.

query
string

The query used to match mentions to the workspace.

channels
enum<string>[]

The unique identifiers of the channels that are part of the workspace.

Available options:
news,
reddit,
telegram,
twitter,
youtube
created
string<date-time>

The date and time the workspace was created.

modified
string<date-time>

The date and time the workspace was last updated.

folder
object | null

The folder, if any, this workspace belongs to.