Inbox desk act

post/workspace/inbox/threads/act

Do one thing to many conversations at once (archive, done, reopen, status, trash, restore, junk, snooze, assign, read, star, label), listed or found by a search (at most 1000). Answers a batch id to undo it.

Before you call

Credential: Authorization: Bearer $KEY
Scope: inbox:write
Mcp: rivier_mail_triage
Graphql: Mutation.inboxDeskAct
Sdk: inbox.desk.act
Cli: inbox desk act

Request bodyapplication/json, required

idslist of string (uuid)
queryobject
- folderstring
  One of: inbox, sent, archive, junk, trash, held, snoozed, starred, all.
- qstring
  At most 500 characters.
actionstringrequired
One of: archive, unarchive, done, reopen, status, trash, restore, junk, notjunk, snooze, unsnooze, assign, unassign, read, unread, star, unstar, label, move_to_inbox.
untilstring
At most 40 characters.
statusstring
One of: open, waiting, done.
assigneestring or null
addlist of string
removelist of string

Responses

200application/json
Success
400application/json
The request was malformed
- errorstringrequired
- messagestring
401application/json
No valid credential
- errorstringrequired
- messagestring
403application/json
The credential lacks the scope, origin or address
- errorstringrequired
- messagestring
429application/json
Over the key's rate limit; see Retry-After
- errorstringrequired
- messagestring

Example request

curl -X POST 'https://api.rivier.ai/workspace/inbox/threads/act' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "action": "archive"
}'

$KEY stands for your own key. No key is shown or kept on this site.

This page as Markdown