Sign inGet Started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

Restore a thread from trash

POST
/v1/email/threads/{thread_id}/restore
const thread = await bird.email.threads.restore("thr_01abc");
console.log(thread.id);
Risposta200
{
  "id": "thr_01krdgeqcxet5s7t44vh8rt9mg",
  "mailbox_id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
  "channel": "email",
  "contact_id": "con_01krdgeqcxet5s7t44vh8rt9mg",
  "subject": "Re: Your order",
  "last_direction": "inbound",
  "folder": "inbox",
  "labels": [
    "urgent"
  ],
  "highlights": {
    "subject": [
      "Re: your **order** **4821**"
    ],
    "text": [
      "confirming your **order** **4821** shipped"
    ]
  }
}

Restores the conversation's unexpired trashed messages and updates its message and unread counts. Messages past their trash deadline or the mailbox retention period stay deleted. Folder, read state and custom labels are preserved. Repeating the operation leaves restored messages unchanged. Previously canceled scheduled sends are not resumed.

Parametri

thread_idstring

Thread identifier. Starts with thr_.

Payload di risposta

id
string
obbligatorio

Thread ID.

mailbox_id
string
obbligatorio

Mailbox this conversation belongs to.

channel
string
obbligatorio

Channel this conversation lives on. Always email.

contact_id
nullable string
obbligatorio

Contact linked to this conversation, or null when none is linked.

subject
nullable string
obbligatorio

Subject of the conversation, taken from its first message. Null when that message had no subject.

participants
array of string
obbligatorio

Addresses that appear on the retained messages in this conversation, including the mailbox's own address.

message_count
integer
obbligatorio

Number of retained messages in this conversation, both directions.

unread_count
integer
obbligatorio

Number of retained received messages that are still unread. Spam and blocked mail is not counted.

last_message_at
string
obbligatorio

When the most recent retained message in this conversation was received or sent.

last_direction
string
obbligatorio

Direction of the most recent message: inbound for a received message, outbound for a sent one.

Possible values: inbound, outbound

folder
string
obbligatorio

Primary conversation folder. The supported folders are inbox, archive, spam, blocked, sent, and trash. Blocked and sent are assigned automatically. The sent filter also includes sent conversations that received replies and still sit in the inbox; moving them with PATCH removes them from the sent filter.

Possible values: inbox, archive, spam, blocked, sent, trash

read
boolean
obbligatorio

Whether every retained received message is read, including trash, spam and blocked messages. Outbound messages do not affect this state.

labels
array of string
obbligatorio

Custom labels applied to this conversation. Folder and read state are separate fields.

created_at
string
obbligatorio

When the thread was created.

updated_at
string
obbligatorio

When the thread last changed.

highlights
object

Matched search fragments, keyed by the field that matched. Returned only by thread search. Omitted when listing threads.

Mostra attributi secondari
scheduled_count
integer

Scheduled or dispatching sends targeting this conversation. Returned by conversation get and list, including zero when none remain. Omitted by search.

next_scheduled_at
string

Earliest due time among scheduled or dispatching sends. Returned by conversation get and list only when scheduled_count is positive. Omitted by search and when no sends remain.

Risorse correlate

Continua con la documentazione, le guide e gli esempi per questo argomento.

Ottieni un brief di implementazione