threads

Update Thread

Changed on Oct 16, 2026

Updates thread labels. Cannot add or remove system labels (sent, received, bounced, etc.). Rejects requests with a 422 for threads with 100 or more messages.

patch/v0/threads/{thread_id}

Request

Base URL
https://api.agentmail.to
URL
https://api.agentmail.to/v0/threads/{thread_id}
Auth
HTTP bearer

Path parameters

thread_idstring required

ID of thread.

Request body

add_labelsstring[]

Labels to add to thread. Cannot be system labels.

remove_labelsstring[]

Labels to remove from thread. Cannot be system labels. Takes priority over add_labels (in the event of duplicate labels passed in).

Response

Response with status 200

thread_idstring required

ID of thread.

labelsstring[] required

Labels of thread.

Changes

Oct 16, 20263f5c7830c952 Revision changes
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- info
  the endpoint scheme security Bearer was added to the API
- info
  the endpoint scheme security BearerAuth was removed from the API
- info
  api tag threads added
- info
  api tag Threads removed
- info
  request body became optional
Jul 15, 2026394ddcdd9c29 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history (3 revisions)