curl 'https://api.mails.ai/v1/threads/thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E/notes' \
  -H "Authorization: Bearer $MAILS_API_KEY"

mails threads notes list thrd_01JABC

{
  "name": "mails_list_thread_notes",
  "arguments": {
    "thread_id": "thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E"
  }
}

{
  "data": [
    {
      "id": "note_01JZX8K3M9Q4P7VN2YB6RTDC0E",
      "object": "<object>",
      "thread_id": "thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E",
      "body": "<body>",
      "author": {
        "kind": "user",
        "id": "usr_01JZX8K3M9Q4P7VN2YB6RTDC0E",
        "email": "jordan@example.com",
        "name": "<name>"
      },
      "created_at": "2026-10-04T12:00:00.000Z"
    }
  ]
}

200  The thread's notes.
401  Missing or invalid API key.
403  The API key lacks the required scope
     (insufficient_scope), or the token belongs to an
     app connected by sign-in and this operation is
     closed to connected apps
     (connected_app_not_allowed).
404  Resource not found in this workspace, or the agent
     a send names is archived (agent_archived).
500  Internal server error.

List a thread's notes

The notes the team left on the thread, oldest first, all at once.

GET/v1/threads/{id}/notesscope · read

curl 'https://api.mails.ai/v1/threads/thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E/notes' \
  -H "Authorization: Bearer $MAILS_API_KEY"

mails threads notes list thrd_01JABC

{
  "name": "mails_list_thread_notes",
  "arguments": {
    "thread_id": "thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E"
  }
}

{
  "data": [
    {
      "id": "note_01JZX8K3M9Q4P7VN2YB6RTDC0E",
      "object": "<object>",
      "thread_id": "thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E",
      "body": "<body>",
      "author": {
        "kind": "user",
        "id": "usr_01JZX8K3M9Q4P7VN2YB6RTDC0E",
        "email": "jordan@example.com",
        "name": "<name>"
      },
      "created_at": "2026-10-04T12:00:00.000Z"
    }
  ]
}

200  The thread's notes.
401  Missing or invalid API key.
403  The API key lacks the required scope
     (insufficient_scope), or the token belongs to an
     app connected by sign-in and this operation is
     closed to connected apps
     (connected_app_not_allowed).
404  Resource not found in this workspace, or the agent
     a send names is archived (agent_archived).
500  Internal server error.

Path Parameters

idstringrequired

Thread id (thrd_…).

Notes stay in mails.ai: none is ever sent, quoted in a reply or forward, or carried by an event.

Response

dataobject[]

Every note on the thread, oldest first; a thread holds at most 500.

Show propertiesHide properties

idstring

Note id (note_…).

objectstring

Always note.

thread_idstring

The thread (thrd_…) the note is on.

bodystring

What the note says, as written. Only the workspace sees it: a note is never sent, never quoted in a reply or forward, and never carried by an event or a webhook.

authorobject

Show propertiesHide properties

kindstring

user for a member signed in to the dashboard, key for an API key or an app connected by sign-in.

One of: user, key

idstring | null

The member's user id (usr_…), the API key's id (key_…) or connected app's id. Null for a member whose account has since been erased.

emailstring

The member's email. Only when kind is user and the member's account still exists.

namestring | null

The member's name, null when they have not given one. Only when email is there.

created_atstring

When the note was added (UTC).

Was this page helpful?