Nylas

Nylas Threads API

Threads. List, search, read and update email threads, and manage thread-level folders and state.

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3/grants/{grant_id}/threads List or search email threads · Return all threads #
Ask an LLM
“Which email conversations have unread messages?”
“Can I find threads with attachments from a specific sender?”
Tell an agent
List email threads for grant {grant}.
Find threads on {grant} from {from} with subject {subject}.
GET /v3/grants/{grant_id}/threads/{thread_id} Get one email thread · Return a thread #
Ask an LLM
“What messages and participants are in a particular conversation?”
“Can I fetch a single thread by its ID?”
Tell an agent
Show thread {thread} for grant {grant}.
Get the conversation {thread} on {grant}.
PUT /v3/grants/{grant_id}/threads/{thread_id} Star, mark read or move a thread · Update a thread #
Ask an LLM
“Can I mark a whole conversation as read in one call?”
“How do I move a thread to a different folder?”
Tell an agent
Mark thread {thread} on grant {grant} as read.
Move thread {thread} for {grant} into folders {folders}.
DELETE /v3/grants/{grant_id}/threads/{thread_id} Move a thread to the trash · Delete a thread #
Ask an LLM
“What happens to the messages when I delete a thread?”
“How do I trash an entire email conversation?”
Tell an agent destructive · confirm first
Trash thread {thread} for grant {grant}.
Delete conversation {thread} and all its messages on {grant}.

Specifications

⚙
OpenAPI
https://artifacts.apis.io/nylas/openapi/nylas-threads-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nylas:nylas-threads-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nylas-threads-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nylas Threads API
  version: v3
  summary: The complete Nylas v3 API — Email, Calendar, Contacts, Notetaker, Scheduling, Administration, and Migration.
  description: The Nylas API is designed using the REST ideology to provide simple and predictable URIs to access and modify objects. Requests support standard HTTP methods like `GET`, `PUT`, `POST`, and `DELETE`, and standard status codes. Response bodies are always UTF-8 encoded JSON objects, unless explicitly documented otherwise. You can use the Nylas Postman collection to quickly start using the Nylas APIs. For more information, check out the Nylas Postman collection documentation.
  contact:
    url: https://www.nylas.com/
servers:
- url: https://api.us.nylas.com
  description: U.S.
- url: https://api.eu.nylas.com
  description: E.U.
security:
- ACCESS_TOKEN: []
- NYLAS_API_KEY: []
tags:


# --- truncated at 32 KB (59 KB total) ---
# Full source: https://artifacts.apis.io/nylas/openapi/nylas-threads-api-openapi.yml