NAiOS IconNAiOS Logo
Volver al catálogo

Happy Scribe

happy_scribe

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

Acciones
24
Triggers
0
Autenticación
OAuth gestionado
No
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