Amara

amara

Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.

Video & Audio 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 (15)

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.

Add Subtitle NoteAMARA_ADD_SUBTITLE_NOTEAcción

Tool to add a note to a subtitle set. use after retrieving the notes uri of the subtitle set.

Parámetros de entrada

bodystringObligatorio
Text of the note to add to the subtitle set.
video_idstringObligatorio
Amara video ID.
language_codestringObligatorio
BCP-47 code for the subtitle 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

Create Subtitle LanguageAMARA_CREATE_SUBTITLE_LANGUAGEAcción

Tool to create a new subtitle language for a video. use when you need to add a language track (iso 639-1 code) before uploading subtitles.

Parámetros de entrada

languagestringObligatorio
ISO 639-1 language code to add (e.g., 'fr').
video_idstringObligatorio
The ID or slug of the video to which to add the subtitle 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

Fetch Subtitles DataAMARA_FETCH_SUBTITLES_DATAAcción

Tool to fetch subtitle data for a video in a specific language. use when you need to retrieve subtitle segments after confirming video id and language code.

Parámetros de entrada

formatstringenum
Subtitle format to retrieve. Defaults to 'json' when omitted.
jsonsrtvtt
video_idstringObligatorio
Amara video ID.
language_codestringObligatorio
BCP-47 code for the subtitle 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

Get Subtitle Language DetailsAMARA_GET_SUBTITLE_LANGUAGE_DETAILSAcción

Tool to retrieve details for a single subtitle language. use when you have video id and language code and need metadata about that language track.

Parámetros de entrada

video_idstringObligatorio
Amara video ID.
language_codestringObligatorio
BCP-47 code for the subtitle 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

Get Team DetailsAMARA_GET_TEAM_DETAILSAcción

Tool to get details on a specific team by slug. use when you need metadata for a single team.

Parámetros de entrada

slugstringObligatorio
Machine name (slug) of the team to retrieve details for.

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

Tool to get user data by username or id. use when you need to fetch account details for a user.

Parámetros de entrada

identifierstringObligatorio
User identifier: username or user ID prefixed with 'id$'.

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 Video URL DetailsAMARA_GET_VIDEO_URL_DETAILSAcción

Tool to get details for a specific video url. use when you have a public or embeddable video url and need its amara metadata (id, title, duration, thumbnails, etc.).

Parámetros de entrada

urlstringObligatorio
A public or embeddable video URL to look up.

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

Tool to get a list of all supported languages. use when you need to know available language options from amara.

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

List Subtitle LanguagesAMARA_LIST_SUBTITLE_LANGUAGESAcción

Tool to list all subtitle languages for a video. use when you have a video id and need to fetch its available subtitle languages.

Parámetros de entrada

video_idstringObligatorio
Amara video ID for which to list subtitle languages.

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

Tool to list all teams. use when you need to retrieve your accessible teams with pagination.

Parámetros de entrada

limitinteger
Maximum number of teams to return.
offsetinteger
Results offset for pagination.

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

Tool to list all videos. use when you need to fetch a paginated list of videos with optional filters.

Parámetros de entrada

pageinteger
Page number of results to fetch.
sortstring
Sorting order, e.g., '-created' or '-primary_audio_language_code'.
teamstring
Filter by team slug.
ownerstring
Filter by owner username.
archiveboolean
If true, only archived videos are returned.
projectstring
Filter by project slug.
languagestring
Filter by language code (BCP-47), e.g., 'en'.
video_idstring
Comma-separated list of video IDs to filter.
page_sizeinteger
Number of results per page.
video_urlstring
Filter by exact video URL.

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

Tool to list all urls associated with a video. use when you need to retrieve every url for embedding or processing.

Parámetros de entrada

limitinteger
Maximum number of URLs to return.
offsetinteger
Index of the first URL to return (0-indexed).
video_idstringObligatorio
Amara video ID for which to list all associated video URLs.

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

Make Video URL PrimaryAMARA_MAKE_VIDEO_URL_PRIMARYAcción

Tool to set a video url as the primary url. use when you need to designate one of a video's urls as primary for embedding and display. call after listing video urls to confirm the url id.

Parámetros de entrada

url_idintegerObligatorio
The internal ID of the video URL resource to mark as primary.
primarybooleanObligatorio
Set to true to mark this URL as the primary URL.
video_idstringObligatorio
The Amara video identifier (e.g., 'NI1hLjBxuTpk').

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

Update Subtitle LanguageAMARA_UPDATE_SUBTITLE_LANGUAGEAcción

Tool to update a subtitle language for a video. use after reviewing existing subtitle language settings and needing to adjust completeness flags or soft-limit constraints.

Parámetros de entrada

video_idstringObligatorio
Amara video ID.
language_codestringObligatorio
BCP-47 code for the subtitle language.
soft_limit_cplinteger
Maximum characters per line; warning shown if exceeded.
soft_limit_cpsinteger
Maximum characters per second; warning shown if exceeded.
soft_limit_linesinteger
Maximum number of lines per subtitle; warning shown if exceeded.
subtitles_completeboolean
Indicates if the subtitles are complete for this language.
soft_limit_max_durationinteger
Maximum subtitle duration in milliseconds; used in guidelines dialog.
soft_limit_min_durationinteger
Minimum subtitle duration in milliseconds; warning shown if violated.
is_primary_audio_languageboolean
Indicates if this is the primary spoken language of the video.

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

View Video DetailsAMARA_VIEW_VIDEO_DETAILSAcción

Tool to view details of a specific video by id. use when you need complete metadata for a given video.

Parámetros de entrada

video_idstringObligatorio
Amara video 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