PUT/api/v1/artifacts/{slug}/captions

Add captions to a video

Adds or replaces a video's captions from a WebVTT (.vtt) or SubRip (.srt) file's text, at most 2 MB. The player shows them as subtitles, and search and Ask read the video by minute. Needs edit rights on the file.

API token required20 per minute per IPMCP: set_captions

Guide: Captions

Code samples and Try it

Path parameters

slugstringRequired
The document's address: the part after markdrop.in/.

Request body

application/json, required

file_namestring
Up to 200 characters.
contentstringRequired
The document's Markdown. 1–2,200,000 characters.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422Not a video, or no captions found in the text (use a .vtt or .srt file).
429Too many requests from your IP address. Wait the seconds in Retry-After.

200 response: 22 fields (ArtifactResponse)

slugstring
urlstring
titlestring | null
Shown on the page and in link previews.
kindstring
Default "artifact".
mimestring
rendererstring
type_labelstring
size_bytesinteger
original_filenamestring | null
artifact_urlstring
workspace_urlstring | null
download_urlstring
poster_urlstring | null
captions_urlstring | null
captions_namestring | null
mediaobject | null
created_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
updated_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
expires_atstring (date-time) | null
ISO 8601, for example 2026-11-30T12:00:00Z.
viewsinteger
Default 0.
is_password_protectedboolean
Default false.
is_ownerboolean
Default false.

curl -X PUT https://api.markdrop.in/api/v1/artifacts/k3x9q2m/captions \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "file_name": "demo.vtt", "content": "WEBVTT\n\n00:00:01.000 --> 00:00:04.000\nWelcome to the demo." }'

const res = await fetch("https://api.markdrop.in/api/v1/artifacts/k3x9q2m/captions", { method: "PUT", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "file_name": "demo.vtt", "content": "WEBVTT\n\n00:00:01.000 --> 00:00:04.000\nWelcome to the demo." }), }); const data = await res.json();

import os import requests r = requests.put( "https://api.markdrop.in/api/v1/artifacts/k3x9q2m/captions", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "file_name": "demo.vtt", "content": "WEBVTT\n\n00:00:01.000 --> 00:00:04.000\nWelcome to the demo.", }, ) r.raise_for_status() print(r.json())