> ## 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.

# Castingwords

> CastingWords offers high-quality, human-powered transcription services with a RESTful API for seamless integration into various workflows.

![Castingwords logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/castingwords.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=542c191b1bbe850146e17a630a0a8d9a)

* **Category:** transcription
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `CASTINGWORDS`
* **Version:** 20261101\_00

## Tools

> [accordion] Cancel and Refund Audio File
>
> **Slug:** `CASTINGWORDS_CANCEL_AUDIOFILE`
>
> Tool to cancel an ordered audio file and issue a refund if applicable. Use when no transcription work has been done on the file (Pre-Processing, Audio Processing, Error states).
>
> #### Input Parameters
>
> **test** `string`
>
> If set to 'true', returns a fake approval for testing. Only valid when audiofile\_id is 100 or 101.
>
> **audiofile\_id** `integer` *required*
>
> ID of the audio file to refund.
>
> #### 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 Prepay Balance
>
> **Slug:** `CASTINGWORDS_GET_PREPAY_BALANCE`
>
> Tool to retrieve the current prepay balance for the account. Use when you need to check available funds before placing new transcription orders.
>
> #### 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 Transcript
>
> **Slug:** `CASTINGWORDS_GET_TRANSCRIPT`
>
> Tool to retrieve the transcript for a given audiofile in the requested format (txt, doc, rtf, or html). Use after a transcription order has been completed.
>
> #### Input Parameters
>
> **test** `string`
>
> If set to '1' or 'true', returns a fake transcript for testing purposes. Only valid with audiofile\_id 100 or 101 and txt extension.
>
> **extension** `string ("txt" | "doc" | "rtf" | "html")`
>
> Output format extension for the transcript. Options: txt (default), doc, rtf, html.
>
> **audiofile\_id** `integer` *required*
>
> The ID of the audiofile to retrieve the transcript for.
>
> #### 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 registered webhook URL
>
> **Slug:** `CASTINGWORDS_GET_WEBHOOK`
>
> Tool to retrieve the currently registered webhook URL for account notifications. Use when you need to verify your webhook setup.
>
> #### 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] Order Transcript
>
> **Slug:** `CASTINGWORDS_ORDER_TRANSCRIPT`
>
> Create a transcription order for audio/video files at publicly accessible URLs and return order and audiofile IDs; test orders are not transcribed. An accepted order may be held for billing, and the response does not expose the hold status.
>
> #### Input Parameters
>
> **sku** `string` *required*
>
> SKU code(s) specifying transcription tier and optional add-ons. Transcription tiers (pick one): TRANS14 (Budget, \~5 day), TRANS2 (1-Day rush), TRANS6 or TRANS7 (7-Day standard). Add-ons (optional, combine with tier): DIFFQ2 (Difficult Audio surcharge), TSTMP1 (Include timestamps), CAPTION1 (Generate captions), VERBATIM1 (Verbatim transcription including filler words). Use SKU\_LIST action to get current pricing.
>
> **url** `string` *required*
>
> Publicly accessible URL or list of URLs of audio/video files to transcribe. The URL must be directly downloadable by CastingWords servers (not behind authentication). Supported formats: MP3 (preferred), WAV, and common video formats.
>
> **name** `array`
>
> List of speaker names to help transcribers identify and label speakers in the transcript. Helpful for multi-speaker recordings.
>
> **test** `boolean`
>
> If true, creates a test order that validates the URL but does not charge or produce a real transcript. Use for testing integrations. Defaults to false.
>
> **notes** `string`
>
> Optional instructions or context for transcribers. Use for special requests like technical terminology, speaker identification guidance, or handling unclear sections.
>
> #### 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] Order Upgrades
>
> **Slug:** `CASTINGWORDS_ORDER_UPGRADES`
>
> Tool to order an upgrade for a specific audio file. Use after transcription is complete to add items like timestamps or extra editing. Example: 'Order timestamps for file 12345'.
>
> #### Input Parameters
>
> **sku** `array` *required*
>
> One or more SKUs to order: DIFFQ2 (Difficult Audio), TSTMP1 (Timestamps), EDIT01 (Extra Editing), UPGRD1 (TRANS14→TRANS6), UPGRD2 (TRANS14→TRANS2), UPGRD3 (TRANS6→TRANS2)
>
> **test** `boolean`
>
> Set to true to run in test mode returning a fake success. Only valid for audiofile IDs 100 and 101.
>
> **audiofile\_id** `integer` *required*
>
> ID of the audio file to upgrade
>
> #### 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] Register Webhook
>
> **Slug:** `CASTINGWORDS_REGISTER_WEBHOOK`
>
> Registers a webhook URL to receive CastingWords event notifications. When events occur (e.g., transcript completion, refund issued, difficult audio), CastingWords will POST to your registered URL with event details. Use CASTINGWORDS\_GET\_WEBHOOK to verify the current webhook, and CASTINGWORDS\_TEST\_WEBHOOK to test notifications.
>
> #### Input Parameters
>
> **webhook** `string` *required*
>
> The HTTP or HTTPS endpoint URL where CastingWords will POST notifications when events occur (e.g., transcript completion, refunds). Must be a valid URL starting with http\:// or https\://.
>
> #### 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 Available SKUs
>
> **Slug:** `CASTINGWORDS_SKU_LIST`
>
> Retrieve available CastingWords service SKU codes and pricing information for use when placing orders. Prices may be per-minute or flat-rate, and some may be unavailable.
>
> #### 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] Test Webhook Call
>
> **Slug:** `CASTINGWORDS_TEST_WEBHOOK`
>
> Tool to request a test webhook call for a specific event type. Use after registering a webhook URL to ensure webhook notifications are functioning properly.
>
> #### Input Parameters
>
> **event** `string ("TRANSCRIPT_COMPLETE" | "DIFFICULT_AUDIO" | "REFUND_ISSUED")` *required*
>
> Type of webhook event to test. One of 'TRANSCRIPT\_COMPLETE', 'DIFFICULT\_AUDIO', or 'REFUND\_ISSUED'.
>
> #### 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
