Skip to main content
BrainGraph logo
  • Category: artificial intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: BRAIN_GRAPH
  • Version: 20261101_00

Tools

Slug: BRAIN_GRAPH_GET_DOCUMENT_PROGRESSGet the current transcription, processing, and analysis status for a BrainGraph document. Poll until transcript.status is analyzed; analysis is null while processing is incomplete.

Input Parameters

integer
required
Document ID returned by a BrainGraph upload or ingestion tool.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_INGEST_WEB_PAGEFetch readable content from a public web page and queue it for BrainGraph ingestion. This creates persistent data and consumes upload and URL-submission quota. After a timeout or other ambiguous failure, check for the document before retrying to avoid a duplicate and additional quota use.

Input Parameters

string
required
Public HTTP(S) web-page URL to fetch. BrainGraph rejects private, loopback, and metadata-service addresses, including after redirects.
string
Optional context to guide extraction and later retrieval.
string
ISO 8601 date associated with the page content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_INGEST_YOUTUBE_VIDEOSubmit a YouTube video for metadata, transcript, and speaker processing; the result may only confirm that processing was queued. Fresh ingestion creates persistent data and counts against the upload cap, while previously ingested videos return an existing record; submissions are rate-limited.

Input Parameters

string
required
YouTube watch, Shorts, embed, live, or youtu.be URL.
string
Optional two-letter caption-track language code, such as en or es.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_LIST_BRAINSList the connected BrainGraph account’s knowledge brains and identify the default brain for filtering or targeting other tools. Accounts without multiple brains enabled receive a 404 instead of a brain list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_LIST_DOCUMENTSList BrainGraph documents newest first, optionally matching filenames or notes, including failed ingestions, and restricting results to selected brains. Returns one page at a time.

Input Parameters

integer
Maximum documents in this page (1-100).
string
Case-insensitive substring to match against document filenames and notes.
string
Opaque continuation cursor returned by a previous call; omit for the first page.
array
Brain IDs to include; omit to list documents across all brains.
boolean
Include documents whose ingestion failed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_LIST_PATTERNSFind recurring relationship-chain patterns in the connected BrainGraph knowledge graph, subject to a minimum occurrence count.

Input Parameters

integer
Maximum patterns to return. BrainGraph does not provide a continuation mechanism for this endpoint.
integer
Minimum number of occurrences required for a recurring pattern.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_RESOLVE_ENTITYResolve an entity name to a canonical BrainGraph record. If there is no single match, return an explicit ambiguous or not-found result rather than treating it as an HTTP error.

Input Parameters

string
required
Entity name to resolve, such as a person, organization, project, or concept.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_SEARCH_BRAINSearch facts in the connected account’s BrainGraph knowledge graph using a natural-language question, optionally restricted to selected brains.

Input Parameters

string
required
Natural-language question or topic to search for in the knowledge graph.
array
Brain IDs to search. Omit to search all brains; this selection is ignored on single-brain accounts.
integer
Maximum number of matching facts to return (1-50).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_TRANSCRIBE_AUDIOUpload an audio file or submit a direct public audio URL for diarized transcription and graph ingestion. This creates persistent data and consumes upload and transcription allowance. Do not retry automatically after an ambiguous failure because a retry can create a duplicate document.

Input Parameters

object
MP3, M4A, WAV, OGG, OGA, OPUS, WEBM, AAC, FLAC, or MP4 file supplied by the caller, up to approximately 150 MB.
string
Optional transcription or extraction context.
string
Target brain ID; omit for the default Personal Brain.
string
Optional display filename for an uploaded file.
string
Direct public HTTP(S) URL of an audio file, not a web player page. Provide exactly one of audio_url or file.
string
ISO 8601 date associated with the recording.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BRAIN_GRAPH_UPLOAD_DOCUMENTUpload a document file supplied by the caller or plain text and queue it for BrainGraph ingestion. This creates persistent data and consumes the account’s upload allowance. After a timeout or other ambiguous failure, check for the document before retrying to avoid a duplicate and additional quota use.

Input Parameters

object
PDF, DOCX, PPTX, TXT, MD, HTML, or EML file supplied by the caller, up to approximately 35 MB.
string
Optional context to guide extraction and later retrieval.
string
Plain-text content to ingest through the JSON endpoint. Provide exactly one of content or file.
string
Target brain ID; omit to use the default Personal Brain.
string
Display filename. Required when content is provided and optional as an override when a file is provided.
string
ISO 8601 date associated with the document or conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not