{"openapi":"3.1.0","info":{"title":"AssemblyAI (BYOK) API","version":"0.1.0","description":"AssemblyAI (BYOK) lets an AI assistant read your own AssemblyAI data through the AssemblyAI API with a key you supply (API key). Read-only: 4 tools (list_transcripts, get_transcript, get_transcript_sentences, get_transcript_paragraphs). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.assemblyai.com....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-assemblyai.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-assemblyai/docs"},"termsOfService":"https://connectorbay.com/byok-assemblyai/terms"},"servers":[{"url":"https://byok-assemblyai.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-assemblyai/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_transcripts":{"post":{"operationId":"list_transcripts","summary":"List your transcripts from the last 30 days, newest first, with id, status, creation and completion time. Page through w","description":"List your transcripts from the last 30 days, newest first, with id, status, creation and completion time. Page through with before_id. Use for \"Which AssemblyAI transcripts did I make recently and did they finish\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many transcripts to return (1 to 200, default 10).","title":"Limit"},"status":{"anyOf":[{"enum":["queued","processing","completed","error"],"type":"string"},{"type":"null"}],"default":null,"description":"Only transcripts with this status.","title":"Status"},"created_on":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transcripts created on this date, YYYY-MM-DD.","title":"Created On"},"before_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transcripts created before this transcript id (for older pages).","title":"Before Id"},"after_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transcripts created after this transcript id (for newer pages).","title":"After Id"}},"title":"list_transcriptsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_transcript":{"post":{"operationId":"get_transcript","summary":"Get one transcript: status, full text, language, duration, confidence, summary if requested, and error. Use for \"What do","description":"Get one transcript: status, full text, language, duration, confidence, summary if requested, and error. Use for \"What does AssemblyAI transcript b33f4691-85b7-4f31-be12-a87cef1c1229 say\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transcript_id":{"description":"Transcript id (UUID) as returned by list_transcripts or when the transcript was created.","maxLength":200,"title":"Transcript Id","type":"string"}},"required":["transcript_id"],"title":"get_transcriptArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_transcript_sentences":{"post":{"operationId":"get_transcript_sentences","summary":"Get a completed transcript split into sentences with start and end times in milliseconds, speaker and confidence. Use fo","description":"Get a completed transcript split into sentences with start and end times in milliseconds, speaker and confidence. Use for \"Show the sentences with timestamps of AssemblyAI transcript b33f4691-85b7-4f31-be12-a87cef1c1229\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transcript_id":{"description":"Transcript id (UUID) as returned by list_transcripts or when the transcript was created.","maxLength":200,"title":"Transcript Id","type":"string"}},"required":["transcript_id"],"title":"get_transcript_sentencesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_transcript_paragraphs":{"post":{"operationId":"get_transcript_paragraphs","summary":"Get a completed transcript split into paragraphs with start and end times in milliseconds and confidence. Use for \"Show ","description":"Get a completed transcript split into paragraphs with start and end times in milliseconds and confidence. Use for \"Show the paragraphs of AssemblyAI transcript b33f4691-85b7-4f31-be12-a87cef1c1229\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transcript_id":{"description":"Transcript id (UUID) as returned by list_transcripts or when the transcript was created.","maxLength":200,"title":"Transcript Id","type":"string"}},"required":["transcript_id"],"title":"get_transcript_paragraphsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}