Live

Fetch one resource live

Changed on

Fetch one resource live by id. A single fetch may fan out into several resources (e.g. a thread → its messages); all are returned. Indexing is skipped for live-only sources and explained in the response notes.

get/live/{source}/resources/{resource_id}

Request

  • Base URL
    https://api.hyperspell.com
  • URL
    https://api.hyperspell.com/live/{source}/resources/{resource_id}
  • Auth
    HTTP bearer

Path parameters

source'reddit' | 'notion' | 'slack' | 'google_calendar' | 'google_mail' | 'imap' | 'google_meet' | 'box' | 'dropbox' | 'github' | 'gitlab' | 'google_drive' | 'vault' | 'web_crawler' | 'trace' | 'microsoft_outlook' | 'microsoft_teams' | 'granola' | 'fathom' | 'fireflies' | 'figma' | 'linear' | 'hubspot' | 'salesforce' | 'coda' | 'confluence' | 'jira' | 'metabase' | 'gong' | 'clickup' | 'lightfield' | 'pylon' | 'fellow' | 'odoo' | 'external_mcp' | 'page' required
resource_idstring required

Query parameters

indexboolean

Queue this resource when the source supports indexing.

connection_idstring nullable

Specific connection id.

Headers

X-Hyperspell-Response-Profile'api' | 'mcp'

Case-sensitive api or mcp. Bounds Google Calendar event and Google Meet, Fathom, Fellow and Gong transcript fetches; other providers retain their existing behavior.

X-As-Userstring nullable

Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token

Response

Successful Response

indexedboolean
notesstring[]

Changes

  • 77d3e8d5e8a7Revision changes
    • warning

      added the new gong enum value to the // response property for the response status

    • info

      added the new enum value gong to the path request parameter source

  • 455cd12eecb3Revision changes
    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status