Happy Scribe
happy_scribeHappy Scribe offers automatic and professional transcription services, converting audio and video files into text with high accuracy.
Acciones disponibles (24)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create SubtitleHAPPY_SCRIBE_CREATE_SUBTITLEAcciónTool to generate subtitles for a video file by creating a transcription with the is_subtitle flag. Use after confirming the media URL is publicly accessible and valid.
HAPPY_SCRIBE_CREATE_SUBTITLEAcciónTool to generate subtitles for a video file by creating a transcription with the is_subtitle flag. Use after confirming the media URL is publicly accessible and valid.
Parámetros de entrada
transcriptionobjectObligatorioTranscription creation parameters
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create TranscriptionHAPPY_SCRIBE_CREATE_TRANSCRIPTIONAcciónTool to initiate a new transcription job using a publicly accessible or signed URL. Use when you have uploaded a media file and want to start transcription immediately.
HAPPY_SCRIBE_CREATE_TRANSCRIPTIONAcciónTool to initiate a new transcription job using a publicly accessible or signed URL. Use when you have uploaded a media file and want to start transcription immediately.
Parámetros de entrada
transcriptionobjectObligatorioTranscription creation payload wrapper.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Translation TaskHAPPY_SCRIBE_CREATE_TRANSLATION_TASKAcciónTool to create a translation task for a transcription (deprecated). Use after transcription is complete to request translation.
HAPPY_SCRIBE_CREATE_TRANSLATION_TASKAcciónTool to create a translation task for a transcription (deprecated). Use after transcription is complete to request translation.
Parámetros de entrada
target_languagestringObligatorioTarget language code to translate into (e.g., 'fr', 'es').
source_transcription_idstringObligatorioID of the transcription to translate; must be in a supported source language.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TranscriptionHAPPY_SCRIBE_DELETE_TRANSCRIPTIONAcciónTool to delete a transcription job. Use when you have a transcription ID and want to remove it, optionally permanently. Use after confirming the transcription ID.
HAPPY_SCRIBE_DELETE_TRANSCRIPTIONAcciónTool to delete a transcription job. Use when you have a transcription ID and want to remove it, optionally permanently. Use after confirming the transcription ID.
Parámetros de entrada
idstringObligatorioUnique identifier of the transcription to delete
permanentbooleanIf true, permanently deletes the transcription; otherwise moves it to Trash (default false)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete WebhookHAPPY_SCRIBE_DELETE_WEBHOOKAcciónTool to delete a specific webhook. Use when you need to remove a webhook after confirming its identifier.
HAPPY_SCRIBE_DELETE_WEBHOOKAcciónTool to delete a specific webhook. Use when you need to remove a webhook after confirming its identifier.
Parámetros de entrada
idstringObligatorioUnique identifier of the webhook to delete
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Export SubtitleHAPPY_SCRIBE_EXPORT_SUBTITLEAcciónTool to export subtitle in the requested format. Use after transcription is completed.
HAPPY_SCRIBE_EXPORT_SUBTITLEAcciónTool to export subtitle in the requested format. Use after transcription is completed.
Parámetros de entrada
exportobjectObligatorioExport configuration object
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Account DetailsHAPPY_SCRIBE_GET_ACCOUNT_DETAILSAcciónTool to retrieve details about your account, including subscription status and usage statistics. Use after authenticating your API key to monitor plan and usage.
HAPPY_SCRIBE_GET_ACCOUNT_DETAILSAcciónTool to retrieve details about your account, including subscription status and usage statistics. Use after authenticating your API key to monitor plan and usage.
Parámetros de entrada
organization_idstringOrganization ID to scope the account information; if omitted, returns default account.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Supported LanguagesHAPPY_SCRIBE_GET_LANGUAGE_LISTAcciónTool to retrieve supported language codes and names. Use when you need the list of valid languages for transcription or subtitle services.
HAPPY_SCRIBE_GET_LANGUAGE_LISTAcciónTool to retrieve supported language codes and names. Use when you need the list of valid languages for transcription or subtitle services.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get API Rate LimitHAPPY_SCRIBE_GET_RATE_LIMITAcciónTool to retrieve current API rate limits. Since Happy Scribe does not expose a dedicated rate limit endpoint, we attempt to read standard rate-limit headers from lightweight GET endpoints (/transcriptions or /version). If headers are unavailable, we fall back to documented defaults (200 requests/hour) with a best-effort estimate.
HAPPY_SCRIBE_GET_RATE_LIMITAcciónTool to retrieve current API rate limits. Since Happy Scribe does not expose a dedicated rate limit endpoint, we attempt to read standard rate-limit headers from lightweight GET endpoints (/transcriptions or /version). If headers are unavailable, we fall back to documented defaults (200 requests/hour) with a best-effort estimate.
Parámetros de entrada
organization_idstringOrganization ID to include when probing list endpoints
endpoint_preferencestringPreferred endpoint to probe for rate limit headers: 'transcriptions', 'version', or 'any'
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Confirm OrderHAPPY_SCRIBE_HS_CONFIRM_ORDERAcciónTool to confirm a pending order. Use after creating an order with confirm=false when you're ready to submit it for processing.
HAPPY_SCRIBE_HS_CONFIRM_ORDERAcciónTool to confirm a pending order. Use after creating an order with confirm=false when you're ready to submit it for processing.
Parámetros de entrada
idstringObligatorioUnique identifier of the order to confirm (UUID format).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Translation OrderHAPPY_SCRIBE_HS_CREATE_TRANSLATION_ORDERAcciónTool to create a translation order from an existing transcription. Use when you have a completed transcription and want translations into one or more languages. By default, the order remains incomplete unless confirm=true.
HAPPY_SCRIBE_HS_CREATE_TRANSLATION_ORDERAcciónTool to create a translation order from an existing transcription. Use when you have a completed transcription and want translations into one or more languages. By default, the order remains incomplete unless confirm=true.
Parámetros de entrada
orderobjectObligatorioWrapper object containing the translation order parameters.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete Subtitle JobHAPPY_SCRIBE_HS_DELETE_SUBTITLEAcciónTool to delete a specific subtitle job. Use when you need to remove a transcription job by its ID after confirming the identifier.
HAPPY_SCRIBE_HS_DELETE_SUBTITLEAcciónTool to delete a specific subtitle job. Use when you need to remove a transcription job by its ID after confirming the identifier.
Parámetros de entrada
idstringObligatorioUnique identifier of the transcription/subtitle job to delete
permanentbooleanIf true, deletion is irreversible; otherwise moves the job to Trash
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Export TranscriptionHAPPY_SCRIBE_HS_EXPORT_TRANSCRIPTIONAcciónTool to export transcription results in various formats. Use after transcription completes to create an export job.
HAPPY_SCRIBE_HS_EXPORT_TRANSCRIPTIONAcciónTool to export transcription results in various formats. Use after transcription completes to create an export job.
Parámetros de entrada
formatstringObligatorioenumOutput format for the export
txtdocxpdfsrtvttstlavidhtmlpremieremaxqdajsonfcpshowCommentsbooleanInclude comments; valid only for txt, docx, pdf
showSpeakersbooleanInclude speaker labels; valid only for txt, docx, pdf
showHighlightsbooleanInclude highlights; valid only for docx, pdf
showTimestampsbooleanInclude timestamps; valid only for txt, docx, pdf
transcriptionIdsstring[]ObligatorioList of transcription IDs to include in the export
showHighlightsOnlybooleanExport only highlighted sections; valid only for docx, pdf
timestampsFrequencystringenumFrequency for inline timecodes
5s10s15s20s30s60s
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get API VersionHAPPY_SCRIBE_HS_GET_API_VERSIONAcciónTool to retrieve current API version and check for updates. If Happy Scribe does not expose a dedicated /version endpoint, this tool attempts to infer the version from HTTP response headers or from the base_url path (e.g., /api/v1).
HAPPY_SCRIBE_HS_GET_API_VERSIONAcciónTool to retrieve current API version and check for updates. If Happy Scribe does not expose a dedicated /version endpoint, this tool attempts to infer the version from HTTP response headers or from the base_url path (e.g., /api/v1).
Parámetros de entrada
organization_idstringOptional organization ID used when probing list endpoints
endpoint_preferencestringPreferred endpoint to probe for version: 'version', 'transcriptions', or 'auto'
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Error CodesHAPPY_SCRIBE_HS_GET_ERROR_CODESAcciónTool to fetch a list of API error codes and their descriptions. Use when you need to understand potential error responses.
HAPPY_SCRIBE_HS_GET_ERROR_CODESAcciónTool to fetch a list of API error codes and their descriptions. Use when you need to understand potential error responses.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get SubtitleHAPPY_SCRIBE_HS_GET_SUBTITLEAcciónTool to retrieve the details and status of a specific subtitle job using its unique identifier. Use when you need to check subtitle job status after submission.
HAPPY_SCRIBE_HS_GET_SUBTITLEAcciónTool to retrieve the details and status of a specific subtitle job using its unique identifier. Use when you need to check subtitle job status after submission.
Parámetros de entrada
idstringObligatorioThe subtitle job unique identifier.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Supported FormatsHAPPY_SCRIBE_HS_GET_SUPPORTED_FORMATSAcciónTool to retrieve supported file formats. Use when you need to know available input and output formats before creating a transcription or subtitle. If a dedicated '/formats' endpoint is unavailable, this action probes known endpoints to verify connectivity and returns a curated list based on official documentation.
HAPPY_SCRIBE_HS_GET_SUPPORTED_FORMATSAcciónTool to retrieve supported file formats. Use when you need to know available input and output formats before creating a transcription or subtitle. If a dedicated '/formats' endpoint is unavailable, this action probes known endpoints to verify connectivity and returns a curated list based on official documentation.
Parámetros de entrada
limitintegerOptional limit on the number of formats returned for each list
test_notestringOptional note used for testing (supports special characters and emoji)
include_audiobooleanInclude audio input formats (e.g., 'mp3', 'wav')
include_videobooleanInclude video input formats (e.g., 'mp4', 'mov')
export_categorystringWhich output formats to include: 'subtitles', 'transcripts', or 'all'
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Transcription DetailsHAPPY_SCRIBE_HS_GET_TRANSCRIPTIONAcciónTool to retrieve details and status of a specific transcription job. Use after creating or listing transcription jobs to inspect a particular job's metadata.
HAPPY_SCRIBE_HS_GET_TRANSCRIPTIONAcciónTool to retrieve details and status of a specific transcription job. Use after creating or listing transcription jobs to inspect a particular job's metadata.
Parámetros de entrada
idstringObligatorioUnique identifier of the transcription job to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get WebhooksHAPPY_SCRIBE_HS_GET_WEBHOOKSAcciónTool to retrieve a list of webhooks configured for your account. Use when you need to view your webhook subscriptions after setup.
HAPPY_SCRIBE_HS_GET_WEBHOOKSAcciónTool to retrieve a list of webhooks configured for your account. Use when you need to view your webhook subscriptions after setup.
Parámetros de entrada
organization_idstringObligatorioOrganization ID to list webhooks from
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List SubtitlesHAPPY_SCRIBE_HS_LIST_SUBTITLESAcciónTool to list subtitle jobs for an organization. Use when you need to retrieve subtitle-specific transcription records with optional filters.
HAPPY_SCRIBE_HS_LIST_SUBTITLESAcciónTool to list subtitle jobs for an organization. Use when you need to retrieve subtitle-specific transcription records with optional filters.
Parámetros de entrada
tostringISO-8601 timestamp to return jobs created at or before this date/time
fromstringISO-8601 timestamp to return jobs created at or after this date/time
pageintegerPage index for pagination (zero-based)
tagsstring[]Filter by one or more tags
statusstringenumFilter by processing state of the job
pendingprocessingautomatic_donefailedfolder_idstringFilter to a specific folder (and its subfolders)
organization_idstringObligatorioOrganization ID to list subtitle jobs from
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve ExportHAPPY_SCRIBE_HS_RETRIEVE_EXPORTAcciónTool to retrieve information about a specific export. Use when you need to check export status and get download link.
HAPPY_SCRIBE_HS_RETRIEVE_EXPORTAcciónTool to retrieve information about a specific export. Use when you need to check export status and get download link.
Parámetros de entrada
idstringObligatorioUnique identifier of the export to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Translation TaskHAPPY_SCRIBE_HS_RETRIEVE_TRANSLATION_TASKAcciónTool to retrieve a translation task by ID (deprecated). Use after creating or listing legacy translation tasks to inspect their status and details.
HAPPY_SCRIBE_HS_RETRIEVE_TRANSLATION_TASKAcciónTool to retrieve a translation task by ID (deprecated). Use after creating or listing legacy translation tasks to inspect their status and details.
Parámetros de entrada
idstringObligatorioUnique identifier of the translation task to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List TranscriptionsHAPPY_SCRIBE_LIST_TRANSCRIPTIONSAcciónTool to list all transcription jobs for an organization with optional filters. Use after you need to fetch transcription records (supports pagination, folder, and tags).
HAPPY_SCRIBE_LIST_TRANSCRIPTIONSAcciónTool to list all transcription jobs for an organization with optional filters. Use after you need to fetch transcription records (supports pagination, folder, and tags).
Parámetros de entrada
pageintegerPage index for pagination (zero-based)
tagsstring[]Filter by one or more tags
folder_idstringFilter to a specific folder (and its subfolders)
organization_idstringObligatorioOrganization ID to list transcriptions from
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve OrderHAPPY_SCRIBE_RETRIEVE_ORDERAcciónTool to retrieve an order by ID. Use when you need details of a specific order after creation.
HAPPY_SCRIBE_RETRIEVE_ORDERAcciónTool to retrieve an order by ID. Use when you need details of a specific order after creation.
Parámetros de entrada
idstringObligatorioUnique identifier of the order to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not