> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadterra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage SDR Threads via API

> List, inspect, and update prospect threads in an SDR's inbox.

SDR prospect threads represent conversations forwarded from campaign replies. Use these endpoints to build agent-driven SDR workflows.

## List inbox threads

```bash theme={null}
curl "https://app.leadterra.co/v1/sdr/inbox?status=new&limit=20" \
  -H "Authorization: Bearer sk_live_your_key"
```

Filter by status, category, search term, or snooze state. Sort by `priority`, `lastMessage`, or `created`.

```json theme={null}
{
  "data": {
    "threads": [
      {
        "id": "thread_id",
        "contactEmail": "ava@example.com",
        "contactName": "Ava Patel",
        "subject": "Re: Quick question",
        "status": "new",
        "category": "A",
        "priorityScore": 85,
        "lastMessageAt": "2026-06-28T18:30:00.000Z"
      }
    ],
    "total": 1,
    "hasMore": false
  }
}
```

## Get thread details

```bash theme={null}
curl https://app.leadterra.co/v1/sdr/inbox/THREAD_ID \
  -H "Authorization: Bearer sk_live_your_key"
```

Returns the thread with participants, linked threads, and MQL handoff context.

## Update thread status

```bash theme={null}
curl -X PUT https://app.leadterra.co/v1/sdr/inbox/THREAD_ID/status \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"status": "awaiting_reply"}'
```

## View conversation history

```bash theme={null}
curl https://app.leadterra.co/v1/sdr/threads/THREAD_ID/messages \
  -H "Authorization: Bearer sk_live_your_key"
```

Returns the full Gmail conversation thread, including original sent emails and prospect replies.