NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Castingwords connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 Castingwords actions, such as "Get Prepay Balance", "Get Transcript" and "Get registered webhook URL". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Castingwords, with input parameters and output schema.
CASTINGWORDS_CANCEL_AUDIOFILETool 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
If set to 'true', returns a fake approval for testing. Only valid when audiofile_id is 100 or 101.
ID of the audio file to refund.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_GET_PREPAY_BALANCETool to retrieve the current prepay balance for the account. Use when you need to check available funds before placing new transcription orders.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_GET_TRANSCRIPTTool 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
If set to '1' or 'true', returns a fake transcript for testing purposes. Only valid with audiofile_id 100 or 101 and txt extension.
Output format extension for the transcript. Options: txt (default), doc, rtf, html.
The ID of the audiofile to retrieve the transcript for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_GET_WEBHOOKTool to retrieve the currently registered webhook URL for account notifications. Use when you need to verify your webhook setup.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_ORDER_TRANSCRIPTCreate a transcription order for audio/video files at publicly accessible URLs. Returns order ID and audiofile IDs for tracking. Requires prepaid balance for non-test orders. Use test=true to validate URLs without charges.
Input parameters
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.
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.
List of speaker names to help transcribers identify and label speakers in the transcript. Helpful for multi-speaker recordings.
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.
Optional instructions or context for transcribers. Use for special requests like technical terminology, speaker identification guidance, or handling unclear sections.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_ORDER_UPGRADESTool 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
One or more SKUs to order: DIFFQ2 (Difficult Audio), TSTMP1 (Timestamps), EDIT01 (Extra Editing), UPGRD1 (TRANS14→TRANS6), UPGRD2 (TRANS14→TRANS2), UPGRD3 (TRANS6→TRANS2)
Set to true to run in test mode returning a fake success. Only valid for audiofile IDs 100 and 101.
ID of the audio file to upgrade
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_REGISTER_WEBHOOKRegisters 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
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_SKU_LISTRetrieves all available CastingWords transcription service SKUs with pricing. Use this tool to discover available services (transcription, captions, etc.) and their per-minute prices before placing an order. Returns SKU codes needed for order placement.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CASTINGWORDS_TEST_WEBHOOKTool 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
Type of webhook event to test. One of 'TRANSCRIPT_COMPLETE', 'DIFFICULT_AUDIO', or 'REFUND_ISSUED'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 9 Castingwords actions on Nagent, including "Get Prepay Balance", "Get Transcript" and "Get registered webhook URL". Get Prepay Balance: Retrieve the current prepay balance for the account. Each action is listed on this page with its input parameters and its output.
Castingwords connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.