Submit an ingest request

post

https://upload.trint.com/ingest

Accepts a source URL and begins asynchronous media ingestion. Returns an operationToken that can be used to correlate webhook callbacks and track the operation.

Workflow

Callback verification — Trint sends an ACTIVITY_STARTED event to the callbackUrl to verify the endpoint responds with 200 OK. If the callback fails, the request is rejected.
202 Accepted — The API returns the operationToken.
Asynchronous processing — Media is downloaded, transcoded, and transcribed. Progress events are sent to the callbackUrl.

Webhook Events

The following events are sent to the callbackUrl as POST requests:

Event Type	Description
`ACTIVITY_STARTED`	Ingest operation has begun
`MEDIA_TRANSFER_COMPLETE`	Media successfully retrieved and stored
`MEDIA_TRANSFER_FAILED`	Media retrieval failed
`TRANSCRIPT_COMPLETE`	Transcription completed successfully
`TRANSCRIPT_FAILED`	Transcription processing failed

Each callback payload includes operationToken, eventType, and the metadata you provided in the original request.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

sourceUrl

uri

required

Source URL from which Trint will retrieve the media file.

filename

string

Display name for the file in the Trint webapp. If omitted, an auto-generated UUID is used.

callbackUrl

uri

required

Required. Webhook URL for receiving progress notifications. Must use http or https protocol. The endpoint must respond with 200 OK to the initial ACTIVITY_STARTED verification event, or the ingest request will be rejected.

metadata

string

length ≤ 1024

Custom metadata string (max 1KB). Returned in all webhook callback payloads.

language

string

Defaults to en-US

Language code for transcription (e.g., en-US, en-GB, fr, de).

folderId

string

ID of the folder to upload to. If the folder belongs to a workspace, sharedDriveId must also be provided.

sharedDriveId

string

ID of the workspace (shared drive) to upload to. Cannot be an archived workspace.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

202Accepted — the ingest operation has been queued for processing.

400Bad Request — invalid or missing parameters.

401Unauthorized — missing or invalid credentials.

403Forbidden — credentials are valid but not permitted. Only API Key v2 and Bearer tokens are accepted.

429Too Many Requests — rate limit exceeded.

503Service Unavailable — the ingest service is temporarily disabled.