> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Grain

> Grain records, transcribes, and organizes meetings so teams can review conversations, share insights, and manage meeting content.

![Grain logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/grain.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=245458e1e7745a0b6f1faf8b2a34dc16)

* **Category:** ai meeting assistants
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 17
* **Triggers:** 0
* **Slug:** `GRAIN`
* **Version:** 00000000\_00

## Tools

> [accordion] Create Hook
>
> **Slug:** `GRAIN_CREATE_HOOK`
>
> Create a Grain webhook subscription after Grain verifies that the public HTTPS callback returns a 2xx response.
>
> #### Input Parameters
>
> **include** `object`
>
> Payload expansions supported by the selected hook type. Recording, highlight, and upload hooks each accept only their documented fields.
>
> **hook\_url** `string` *required*
>
> Public HTTPS callback URL. Grain sends a POST reachability test during creation, and the callback must return a 2xx response.
>
> **hook\_type** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Upload
>
> **Slug:** `GRAIN_CREATE_UPLOAD`
>
> Create 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
>
> **include** `object`
>
> Optional data to include in the returned upload.
>
> **attributes** `object`
>
> Metadata for the upload. Required with a transcript when media\_type is transcript.
>
> **media\_type** `string ("video" | "audio" | "transcript")` *required*
>
> Type of upload to create.
>
> **auto\_promote** `boolean`
>
> Whether Grain should automatically promote the completed upload into a recording. Set false to review it while staged and promote it later.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Hook
>
> **Slug:** `GRAIN_DELETE_HOOK`
>
> Permanently delete one Grain webhook subscription.
>
> #### Input Parameters
>
> **hook\_id** `string` *required*
>
> Hook ID returned by GRAIN\_CREATE\_HOOK or GRAIN\_LIST\_HOOKS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Recording
>
> **Slug:** `GRAIN_DOWNLOAD_RECORDING`
>
> Download a recording's original audio or video media through Composio file storage. Use the transcript action instead when transcript text is needed.
>
> #### Input Parameters
>
> **recording\_id** `string` *required*
>
> Recording ID whose original audio or video media file to download.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Connection Info
>
> **Slug:** `GRAIN_GET_CONNECTION_INFO`
>
> Identify the connected Grain user or workspace and report the connection's authentication type, scope, and expiry without exposing credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Recording
>
> **Slug:** `GRAIN_GET_RECORDING`
>
> Get one Grain recording by ID, optionally including participants, summaries, notes, and other expanded meeting data.
>
> #### Input Parameters
>
> **include** `object`
>
> Expanded recording data to include in the response.
>
> **recording\_id** `string` *required*
>
> Recording ID returned by GRAIN\_LIST\_RECORDINGS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Recording Transcript
>
> **Slug:** `GRAIN_GET_RECORDING_TRANSCRIPT`
>
> Get a Grain recording transcript as structured speaker segments, plain text, WebVTT, or SRT.
>
> #### Input Parameters
>
> **format** `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.
>
> **recording\_id** `string` *required*
>
> Recording ID whose transcript to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Upload
>
> **Slug:** `GRAIN_GET_UPLOAD`
>
> Get one Grain upload by ID, including its processing status and optional attributes or transcript data.
>
> #### Input Parameters
>
> **upload\_id** `string` *required*
>
> Upload ID returned by GRAIN\_CREATE\_UPLOAD or GRAIN\_LIST\_UPLOADS.
>
> **include\_attributes** `boolean`
>
> Whether to include the upload attributes, excluding transcript data.
>
> **include\_transcript** `boolean`
>
> Whether to include transcript data in the upload attributes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Hooks
>
> **Slug:** `GRAIN_LIST_HOOKS`
>
> List Grain webhook subscriptions, optionally filtering by event type or enabled state.
>
> #### Input Parameters
>
> **state** `string ("enabled" | "disabled")`
>
> Restrict results to enabled or disabled hooks.
>
> **hook\_type** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Recordings
>
> **Slug:** `GRAIN_LIST_RECORDINGS`
>
> Return one page of recordings visible to the connected Grain user, with optional search filters and expanded meeting data.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque cursor from a previous response; omit for the first page.
>
> **filter** `object`
>
> Optional filters applied to the recording list.
>
> **include** `object`
>
> Expanded fields to include on each recording.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Reference Data
>
> **Slug:** `GRAIN_LIST_REFERENCE_DATA`
>
> List visible Grain users, teams, or meeting types and return their IDs for recording filters, sharing, and upload metadata.
>
> #### Input Parameters
>
> **resource\_type** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Uploads
>
> **Slug:** `GRAIN_LIST_UPLOADS`
>
> Return one page of Grain uploads, optionally filtered by media type and expanded with attributes or transcript data.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque cursor from a previous response; omit for the first page.
>
> **media\_type** `string ("video" | "audio" | "transcript")`
>
> Restrict results to one media type.
>
> **include\_attributes** `boolean`
>
> Include upload attributes other than transcript data.
>
> **include\_transcript** `boolean`
>
> Include transcript data in each upload's attributes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Promote Upload
>
> **Slug:** `GRAIN_PROMOTE_UPLOAD`
>
> Start 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
>
> **upload\_id** `string` *required*
>
> Staged upload ID created with auto\_promote=false.
>
> **include\_attributes** `boolean`
>
> Whether to include upload attributes in the response.
>
> **include\_transcript** `boolean`
>
> Whether to include transcript data in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Recording Access
>
> **Slug:** `GRAIN_UPDATE_RECORDING_ACCESS`
>
> Share a recording with one Grain user or team, or remove that user or team's access.
>
> #### Input Parameters
>
> **operation** `string ("share" | "unshare")` *required*
>
> Whether to grant or remove the principal's access.
>
> **principal\_id** `string` *required*
>
> User or team ID returned by GRAIN\_LIST\_REFERENCE\_DATA.
>
> **recording\_id** `string` *required*
>
> Recording ID whose access to change.
>
> **principal\_type** `string ("user" | "team")` *required*
>
> Whether principal\_id identifies a Grain user or team.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Recording Tag
>
> **Slug:** `GRAIN_UPDATE_RECORDING_TAG`
>
> Add or remove one tag on a Grain recording.
>
> #### Input Parameters
>
> **tag** `string` *required*
>
> Tag made of letters or numbers separated by hyphens.
>
> **operation** `string ("add" | "remove")` *required*
>
> Whether to add the tag or remove it.
>
> **recording\_id** `string` *required*
>
> Recording ID whose tags to change.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Recording Title
>
> **Slug:** `GRAIN_UPDATE_RECORDING_TITLE`
>
> Replace the title of an existing Grain recording.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> New recording title.
>
> **recording\_id** `string` *required*
>
> Recording ID to rename.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Upload
>
> **Slug:** `GRAIN_UPDATE_UPLOAD`
>
> Replace attributes on an awaiting or manually staged Grain upload before it is promoted.
>
> #### Input Parameters
>
> **upload\_id** `string` *required*
>
> Awaiting or manually staged upload ID to update.
>
> **attributes** `object` *required*
>
> Replacement upload attributes. Omitted attributes are removed or reset by Grain.
>
> **include\_attributes** `boolean`
>
> Include the updated upload attributes in the response.
>
> **include\_transcript** `boolean`
>
> Include transcript data in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
