Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Path Parameters

inbox_id
string
required

Inbox id (inbox_…)

Body

application/json

At least one of add_labels or remove_labels is required.

message_ids
string[]
required

Message ids (msg_…), up to 50, no duplicates

Maximum array length: 50
add_labels

Labels to add. Crevio uses unread (new incoming mail), starred and archived (out of the inbox, still listed) like Gmail; spam and trash hide the mail from lists and search until removed. held can't be changed through the API.

remove_labels

Labels to remove. Removing spam or trash brings the mail back.

Response

Updated messages

limit
integer
required

Number of ids sent

count
integer
required

Number of messages updated

updates
object[]
required