Skip to main content
Grain logo
  • Category: ai meeting assistants
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 17
  • Triggers: 0
  • Slug: GRAIN
  • Version: 00000000_00

Tools

Slug: GRAIN_CREATE_HOOKCreate a Grain webhook subscription after Grain verifies that the public HTTPS callback returns a 2xx response.

Input Parameters

object
Payload expansions supported by the selected hook type. Recording, highlight, and upload hooks each accept only their documented fields.
string
required
Public HTTPS callback URL. Grain sends a POST reachability test during creation, and the callback must return a 2xx response.
string ("recording_added" | "recording_updated" | "recording_deleted" | "highlight_added" | "highlight_updated" | "highlight_deleted" | "story_added" | "story_updated" | "story_deleted" | "upload_added" | "upload_updated")
required
Event type to subscribe to.

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: GRAIN_CREATE_UPLOADCreate a Grain transcript upload or an audio/video upload slot. Transcript content is submitted in this call. By default, Grain automatically promotes the completed upload into a recording; set auto_promote=false to stage it instead. Automatic promotion creates a recording that cannot be undone through Grain’s documented API. Audio/video responses provide signed PUT instructions, but this action does not transfer media bytes.

Input Parameters

object
Optional data to include in the returned upload.
object
Metadata for the upload. Required with a transcript when media_type is transcript.
string ("video" | "audio" | "transcript")
required
Type of upload to create.
boolean
Whether Grain should automatically promote the completed upload into a recording. Set false to review it while staged and promote it later.

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: GRAIN_DELETE_HOOKPermanently delete one Grain webhook subscription.

Input Parameters

string
required
Hook ID returned by GRAIN_CREATE_HOOK or GRAIN_LIST_HOOKS.

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: GRAIN_DOWNLOAD_RECORDINGDownload a recording’s original audio or video media through Composio file storage. Use the transcript action instead when transcript text is needed.

Input Parameters

string
required
Recording ID whose original audio or video media file to download.

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: GRAIN_GET_CONNECTION_INFOIdentify the connected Grain user or workspace and report the connection’s authentication type, scope, and expiry without exposing credentials.

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: GRAIN_GET_RECORDINGGet one Grain recording by ID, optionally including participants, summaries, notes, and other expanded meeting data.

Input Parameters

object
Expanded recording data to include in the response.
string
required
Recording ID returned by GRAIN_LIST_RECORDINGS.

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: GRAIN_GET_RECORDING_TRANSCRIPTGet a Grain recording transcript as structured speaker segments, plain text, WebVTT, or SRT.

Input Parameters

string ("json" | "text" | "vtt" | "srt")
Transcript representation: json for timed speaker segments, text for readable prose, vtt for WebVTT captions, or srt for SubRip captions.
string
required
Recording ID whose transcript to retrieve.

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: GRAIN_GET_UPLOADGet one Grain upload by ID, including its processing status and optional attributes or transcript data.

Input Parameters

string
required
Upload ID returned by GRAIN_CREATE_UPLOAD or GRAIN_LIST_UPLOADS.
boolean
Whether to include the upload attributes, excluding transcript data.
boolean
Whether to include transcript data in the upload attributes.

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: GRAIN_LIST_HOOKSList Grain webhook subscriptions, optionally filtering by event type or enabled state.

Input Parameters

string ("enabled" | "disabled")
Restrict results to enabled or disabled hooks.
string ("recording_added" | "recording_updated" | "recording_deleted" | "highlight_added" | "highlight_updated" | "highlight_deleted" | "story_added" | "story_updated" | "story_deleted" | "upload_added" | "upload_updated")
Restrict results to one webhook event type.

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: GRAIN_LIST_RECORDINGSReturn one page of recordings visible to the connected Grain user, with optional search filters and expanded meeting data.

Input Parameters

string
Opaque cursor from a previous response; omit for the first page.
object
Optional filters applied to the recording list.
object
Expanded fields to include on each 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: GRAIN_LIST_REFERENCE_DATAList visible Grain users, teams, or meeting types and return their IDs for recording filters, sharing, and upload metadata.

Input Parameters

string ("users" | "teams" | "meeting_types")
required
Reference collection to return: users for user IDs, teams for team IDs, or meeting_types for meeting classification IDs.

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: GRAIN_LIST_UPLOADSReturn one page of Grain uploads, optionally filtered by media type and expanded with attributes or transcript data.

Input Parameters

string
Opaque cursor from a previous response; omit for the first page.
string ("video" | "audio" | "transcript")
Restrict results to one media type.
boolean
Include upload attributes other than transcript data.
boolean
Include transcript data in each upload’s attributes.

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: GRAIN_PROMOTE_UPLOADStart promotion of a manually staged Grain upload into a recording. This creates a recording and cannot be undone through Grain’s documented API.

Input Parameters

string
required
Staged upload ID created with auto_promote=false.
boolean
Whether to include upload attributes in the response.
boolean
Whether to include transcript data in the response.

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: GRAIN_UPDATE_RECORDING_ACCESSShare a recording with one Grain user or team, or remove that user or team’s access.

Input Parameters

string ("share" | "unshare")
required
Whether to grant or remove the principal’s access.
string
required
User or team ID returned by GRAIN_LIST_REFERENCE_DATA.
string
required
Recording ID whose access to change.
string ("user" | "team")
required
Whether principal_id identifies a Grain user or team.

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: GRAIN_UPDATE_RECORDING_TAGAdd or remove one tag on a Grain recording.

Input Parameters

string
required
Tag made of letters or numbers separated by hyphens.
string ("add" | "remove")
required
Whether to add the tag or remove it.
string
required
Recording ID whose tags to change.

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: GRAIN_UPDATE_RECORDING_TITLEReplace the title of an existing Grain recording.

Input Parameters

string
required
New recording title.
string
required
Recording ID to rename.

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: GRAIN_UPDATE_UPLOADReplace attributes on an awaiting or manually staged Grain upload before it is promoted.

Input Parameters

string
required
Awaiting or manually staged upload ID to update.
object
required
Replacement upload attributes. Omitted attributes are removed or reset by Grain.
boolean
Include the updated upload attributes in the response.
boolean
Include transcript data in the response.

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