---
title: "Describe a source's full live query surface"
method: GET
path: "/live/{source}/manifest"
tags: ["Live"]
---

# Describe a source's full live query surface

`GET /live/{source}/manifest`

Return the source's capability manifest: capabilities, the raw read surface,
and guidance — what the caller can compose a query against.

## 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

## Query parameters

- `connection_id` string, nullable — Specific connection id.

## Response `200`

Successful Response

- SourceManifestResponse — Everything the caller can ask of a source — read before composing a query.
  - `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
  - `auth_provider` 'nango' | 'unified' | 'whitelabel', required
  - `capabilities` Capability[], required
  - `raw_read_ops` RawReadOp[], required
    - `name` string, required
    - `method` 'GET' | 'POST'
    - `path` string, required
    - `description` string, required
    - `params` object
    - `graphql` boolean
  - `raw_discovery` string, required
  - `guidance` string[]
  - `resolvable` 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)