# Tldv

Meeting recorder and transcription tool for video conferences

- **Category:** productivity
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `TLDV`
- **Version:** 20260312_00

## Tools

### Check API Health

**Slug:** `TLDV_CHECK_HEALTH`

Tool to verify API availability and health status. Use when you need to check if the tl;dv API is operational before making other API calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Meeting Recording

**Slug:** `TLDV_DOWNLOAD_MEETING_RECORDING`

Tool to download a meeting recording file. Returns the recording file by following the API's redirect to a signed download URL (valid for 6 hours). Use when you need to retrieve the actual recording content for a specific meeting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meeting_id` | string | Yes | The unique identifier of the meeting whose recording should be downloaded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meeting

**Slug:** `TLDV_GET_MEETING`

Tool to retrieve a meeting by its unique identifier. Returns detailed meeting metadata including id, name, date, URL, duration, organizer, invitees, template, and extra properties. Use when you need to fetch information about a specific meeting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meetingId` | string | Yes | The unique identifier of the meeting to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meeting Highlights

**Slug:** `TLDV_GET_MEETING_HIGHLIGHTS`

Tool to retrieve meeting notes (highlights) by meeting ID in human-readable format. Use when you need to fetch notes from a completed meeting. Highlights are only returned if the transcript is complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meetingId` | string | Yes | The unique identifier of the meeting to retrieve highlights for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meeting Transcript

**Slug:** `TLDV_GET_MEETING_TRANSCRIPT`

Tool to retrieve the complete transcript of a meeting by its ID. Returns transcript segments with speaker names, text, and timestamps. The transcript is only returned if it is complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meetingId` | string | Yes | The unique identifier of the meeting to retrieve the transcript for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import Meeting

**Slug:** `TLDV_IMPORT_MEETING`

Tool to import a meeting, recording, or other media from a publicly accessible URL. The URL must point to media in a supported format (mp3, mp4, wav, m4a, mkv, mov, avi, wma, flac). Returns a job ID to track the import progress. Use when you need to add external recordings to tldv.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The publicly accessible URL to import the meeting/recording from. Must be in a supported format (mp3, mp4, wav, m4a, mkv, mov, avi, wma, flac) |
| `name` | string | No | Optional name/title for the imported meeting |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Meetings

**Slug:** `TLDV_LIST_MEETINGS`

Tool to retrieve a paginated list of meetings from tldv. Returns meeting metadata including id, name, occurrence date, URL, duration, organizer details, invitees, and template information. Use when you need to view recorded meetings or search for specific meeting details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meetingType` | string ("internal" | "external") | No | Type of meeting to filter by. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |