curl "https://api.gork.email/v1/threads?inboxId=inb_728af980b4e&limit=20" \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const threads = await gork.threads.list({ inboxId: "inb_728af980b4e", limit: 20 })
import requests, os
res = requests.get(
"https://api.gork.email/v1/threads",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
params={"inboxId": "inb_728af980b4e", "limit": 20},
)
{
"data": [
{
"id": "thd_128bca90f4",
"organizationId": "org_1a2b3c4d",
"inboxId": "inb_728af980b4e",
"subject": "Invoice 1042",
"snippet": "Invoice attached.",
"messageCount": 2,
"lastMessageAt": "2026-09-11T08:05:00.000Z",
"isArchived": false,
"createdAt": "2026-09-11T08:00:00.000Z"
}
]
}
Threads
List Threads
List conversation threads for your organization, most recently active first.
GET
/
v1
/
threads
curl "https://api.gork.email/v1/threads?inboxId=inb_728af980b4e&limit=20" \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const threads = await gork.threads.list({ inboxId: "inb_728af980b4e", limit: 20 })
import requests, os
res = requests.get(
"https://api.gork.email/v1/threads",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
params={"inboxId": "inb_728af980b4e", "limit": 20},
)
{
"data": [
{
"id": "thd_128bca90f4",
"organizationId": "org_1a2b3c4d",
"inboxId": "inb_728af980b4e",
"subject": "Invoice 1042",
"snippet": "Invoice attached.",
"messageCount": 2,
"lastMessageAt": "2026-09-11T08:05:00.000Z",
"isArchived": false,
"createdAt": "2026-09-11T08:00:00.000Z"
}
]
}
Returns threads ordered by
lastMessageAt descending (most recently active first).
Headers
string
required
Bearer token formatted as
Bearer gork_live_.... Requires the threads:read scope.Query parameters
string
Restrict to threads in one inbox. Inbox-bound keys are always restricted to their own inbox regardless of this value.
number
default:"50"
Maximum threads to return, 1–100.
Response
object[]
Show properties
Show properties
string
Unique thread ID (
thd_...).string
The inbox this thread belongs to.
string
Thread subject.
string
Preview of the latest message body.
number
Number of messages in the thread.
string
ISO 8601 timestamp of the most recent message.
boolean
Whether the thread has been archived.
string
ISO 8601 creation timestamp.
curl "https://api.gork.email/v1/threads?inboxId=inb_728af980b4e&limit=20" \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const threads = await gork.threads.list({ inboxId: "inb_728af980b4e", limit: 20 })
import requests, os
res = requests.get(
"https://api.gork.email/v1/threads",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
params={"inboxId": "inb_728af980b4e", "limit": 20},
)
{
"data": [
{
"id": "thd_128bca90f4",
"organizationId": "org_1a2b3c4d",
"inboxId": "inb_728af980b4e",
"subject": "Invoice 1042",
"snippet": "Invoice attached.",
"messageCount": 2,
"lastMessageAt": "2026-09-11T08:05:00.000Z",
"isArchived": false,
"createdAt": "2026-09-11T08:00:00.000Z"
}
]
}
To read the full conversation with every message, fetch one thread with
GET /v1/threads/{id}.