---
name: assemblyai-api
description: "AssemblyAI API skill. Use when working with AssemblyAI for upload, transcript. Covers 10 endpoints."
version: 1.0.0
generator: lapsh
---

# AssemblyAI API
API version: 1.3.4

## Auth
ApiKey Authorization in header

## Base URL
https://api.assemblyai.com

## Setup
1. Set your API key in the appropriate header
2. GET /v2/transcript -- list transcripts
3. POST /v2/upload -- create first upload

## Endpoints
10 endpoints across 2 groups. See references/api-spec.lap for full details.

### Upload
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/upload | Upload a media file |

### Transcript
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/transcript | Transcribe audio |
| GET | /v2/transcript | List transcripts |
| GET | /v2/transcript/{transcript_id} | Get transcript |
| DELETE | /v2/transcript/{transcript_id} | Delete transcript |
| GET | /v2/transcript/{transcript_id}/{subtitle_format} | Get subtitles for transcript |
| GET | /v2/transcript/{transcript_id}/sentences | Get sentences in transcript |
| GET | /v2/transcript/{transcript_id}/paragraphs | Get paragraphs in transcript |
| GET | /v2/transcript/{transcript_id}/word-search | Search words in transcript |
| GET | /v2/transcript/{transcript_id}/redacted-audio | Get redacted audio |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a upload?" -> POST /v2/upload
- "Create a transcript?" -> POST /v2/transcript
- "List all transcript?" -> GET /v2/transcript
- "Get transcript details?" -> GET /v2/transcript/{transcript_id}
- "Delete a transcript?" -> DELETE /v2/transcript/{transcript_id}
- "List all sentences?" -> GET /v2/transcript/{transcript_id}/sentences
- "List all paragraphs?" -> GET /v2/transcript/{transcript_id}/paragraphs
- "List all word-search?" -> GET /v2/transcript/{transcript_id}/word-search
- "List all redacted-audio?" -> GET /v2/transcript/{transcript_id}/redacted-audio
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Create/update endpoints return the modified resource on success
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)