Happy Scribe

happy_scribe

Happy Scribe offers automatic and professional transcription services, converting audio and video files into text with high accuracy.

Transcription Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool 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

transcriptionobjectObligatorio
Transcription creation parameters

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create TranscriptionHAPPY_SCRIBE_CREATE_TRANSCRIPTIONAcción

Tool 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

transcriptionobjectObligatorio
Transcription creation payload wrapper.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Translation TaskHAPPY_SCRIBE_CREATE_TRANSLATION_TASKAcción

Tool to create a translation task for a transcription (deprecated). Use after transcription is complete to request translation.

Parámetros de entrada

target_languagestringObligatorio
Target language code to translate into (e.g., 'fr', 'es').
source_transcription_idstringObligatorio
ID of the transcription to translate; must be in a supported source language.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete TranscriptionHAPPY_SCRIBE_DELETE_TRANSCRIPTIONAcción

Tool 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

idstringObligatorio
Unique identifier of the transcription to delete
permanentboolean
If true, permanently deletes the transcription; otherwise moves it to Trash (default false)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete WebhookHAPPY_SCRIBE_DELETE_WEBHOOKAcción

Tool to delete a specific webhook. Use when you need to remove a webhook after confirming its identifier.

Parámetros de entrada

idstringObligatorio
Unique identifier of the webhook to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Export SubtitleHAPPY_SCRIBE_EXPORT_SUBTITLEAcción

Tool to export subtitle in the requested format. Use after transcription is completed.

Parámetros de entrada

exportobjectObligatorio
Export configuration object

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Account DetailsHAPPY_SCRIBE_GET_ACCOUNT_DETAILSAcción

Tool 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_idstring
Organization ID to scope the account information; if omitted, returns default account.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Supported LanguagesHAPPY_SCRIBE_GET_LANGUAGE_LISTAcción

Tool 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

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get API Rate LimitHAPPY_SCRIBE_GET_RATE_LIMITAcción

Tool 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_idstring
Organization ID to include when probing list endpoints
endpoint_preferencestring
Preferred endpoint to probe for rate limit headers: 'transcriptions', 'version', or 'any'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Confirm OrderHAPPY_SCRIBE_HS_CONFIRM_ORDERAcción

Tool 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

idstringObligatorio
Unique identifier of the order to confirm (UUID format).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Translation OrderHAPPY_SCRIBE_HS_CREATE_TRANSLATION_ORDERAcción

Tool 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

orderobjectObligatorio
Wrapper object containing the translation order parameters.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Subtitle JobHAPPY_SCRIBE_HS_DELETE_SUBTITLEAcción

Tool 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

idstringObligatorio
Unique identifier of the transcription/subtitle job to delete
permanentboolean
If true, deletion is irreversible; otherwise moves the job to Trash

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Export TranscriptionHAPPY_SCRIBE_HS_EXPORT_TRANSCRIPTIONAcción

Tool to export transcription results in various formats. Use after transcription completes to create an export job.

Parámetros de entrada

formatstringObligatorioenum
Output format for the export
txtdocxpdfsrtvttstlavidhtmlpremieremaxqdajsonfcp
showCommentsboolean
Include comments; valid only for txt, docx, pdf
showSpeakersboolean
Include speaker labels; valid only for txt, docx, pdf
showHighlightsboolean
Include highlights; valid only for docx, pdf
showTimestampsboolean
Include timestamps; valid only for txt, docx, pdf
transcriptionIdsstring[]Obligatorio
List of transcription IDs to include in the export
showHighlightsOnlyboolean
Export only highlighted sections; valid only for docx, pdf
timestampsFrequencystringenum
Frequency for inline timecodes
5s10s15s20s30s60s

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get API VersionHAPPY_SCRIBE_HS_GET_API_VERSIONAcción

Tool 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_idstring
Optional organization ID used when probing list endpoints
endpoint_preferencestring
Preferred endpoint to probe for version: 'version', 'transcriptions', or 'auto'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Error CodesHAPPY_SCRIBE_HS_GET_ERROR_CODESAcción

Tool 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

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get SubtitleHAPPY_SCRIBE_HS_GET_SUBTITLEAcción

Tool 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

idstringObligatorio
The subtitle job unique identifier.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Supported FormatsHAPPY_SCRIBE_HS_GET_SUPPORTED_FORMATSAcción

Tool 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

limitinteger
Optional limit on the number of formats returned for each list
test_notestring
Optional note used for testing (supports special characters and emoji)
include_audioboolean
Include audio input formats (e.g., 'mp3', 'wav')
include_videoboolean
Include video input formats (e.g., 'mp4', 'mov')
export_categorystring
Which output formats to include: 'subtitles', 'transcripts', or 'all'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Transcription DetailsHAPPY_SCRIBE_HS_GET_TRANSCRIPTIONAcción

Tool 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

idstringObligatorio
Unique identifier of the transcription job to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get WebhooksHAPPY_SCRIBE_HS_GET_WEBHOOKSAcción

Tool 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_idstringObligatorio
Organization ID to list webhooks from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SubtitlesHAPPY_SCRIBE_HS_LIST_SUBTITLESAcción

Tool to list subtitle jobs for an organization. Use when you need to retrieve subtitle-specific transcription records with optional filters.

Parámetros de entrada

tostring
ISO-8601 timestamp to return jobs created at or before this date/time
fromstring
ISO-8601 timestamp to return jobs created at or after this date/time
pageinteger
Page index for pagination (zero-based)
tagsstring[]
Filter by one or more tags
statusstringenum
Filter by processing state of the job
pendingprocessingautomatic_donefailed
folder_idstring
Filter to a specific folder (and its subfolders)
organization_idstringObligatorio
Organization ID to list subtitle jobs from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve ExportHAPPY_SCRIBE_HS_RETRIEVE_EXPORTAcción

Tool to retrieve information about a specific export. Use when you need to check export status and get download link.

Parámetros de entrada

idstringObligatorio
Unique identifier of the export to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve Translation TaskHAPPY_SCRIBE_HS_RETRIEVE_TRANSLATION_TASKAcción

Tool 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

idstringObligatorio
Unique identifier of the translation task to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List TranscriptionsHAPPY_SCRIBE_LIST_TRANSCRIPTIONSAcción

Tool 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

pageinteger
Page index for pagination (zero-based)
tagsstring[]
Filter by one or more tags
folder_idstring
Filter to a specific folder (and its subfolders)
organization_idstringObligatorio
Organization ID to list transcriptions from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve OrderHAPPY_SCRIBE_RETRIEVE_ORDERAcción

Tool to retrieve an order by ID. Use when you need details of a specific order after creation.

Parámetros de entrada

idstringObligatorio
Unique identifier of the order to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not