---
title: "Raw live read against a source"
method: POST
path: "/live/{source}/passthrough"
tags: ["Live"]
---

# Raw live read against a source

`POST /live/{source}/passthrough`

Read a source live through Unified passthrough using a provider-native path.

Read-only: the (method, path) is validated against the source's declared read
surface before any provider call; writes are rejected (405).

## Path parameters

- `source` 'reddit' | 'notion' | 'slack' | 'google_calendar' | 'google_mail' | 'box' | 'dropbox' | 'github' | 'google_drive' | 'vault' | 'web_crawler' | 'trace' | 'microsoft_teams' | 'gmail_actions' | 'granola' | 'fathom' | 'fireflies' | 'linear' | 'hubspot' | 'salesforce' | 'coda' | 'lightfield' | 'gong', required

## Request body

- PassthroughRequest
  - `method` 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE' — Provider HTTP method. Writes (PATCH/PUT/DELETE) are rejected.
  - `path` string, required — Provider-native path, e.g. 'gmail/v1/users/me/messages'.
  - `query` object, nullable — Query-string params for GET reads.
  - `body` object, nullable — JSON body for read-via-POST (e.g. GraphQL).
  - `connection_id` string, nullable — Specific connection id when the user has multiple.

## Response `200`

Successful Response

- PassthroughResponse — A raw passthrough read: the provider's payload verbatim, plus what happened.
  - `source` 'reddit' | 'notion' | 'slack' | 'google_calendar' | 'google_mail' | 'box' | 'dropbox' | 'github' | 'google_drive' | 'vault' | 'web_crawler' | 'trace' | 'microsoft_teams' | 'gmail_actions' | 'granola' | 'fathom' | 'fireflies' | 'linear' | 'hubspot' | 'salesforce' | 'coda' | 'lightfield' | 'gong', required
  - `method` string, required
  - `path` string, required
  - `payload` unknown, required
  - `truncated` boolean
  - `notes` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hyperspell/apis/hyperspell-api.md) · [All operations](https://skmtc.net/hyperspell/apis/hyperspell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperspell/hyperspell-api/revisions/5721acd588e6/schema)