From b15473e9da3f72602f6e66cb57bfe70728742d3c Mon Sep 17 00:00:00 2001 From: Abdelrahman Essawy Date: Tue, 23 Jun 2026 00:39:03 +0300 Subject: [PATCH] docs: fix compose trim example, valid sample URL, drop filler phrases --- guides/webhooks.mdx | 4 ++-- jobs/compose.mdx | 17 ++++++++--------- support/faq.mdx | 4 ++-- 3 files changed, 12 insertions(+), 13 deletions(-) diff --git a/guides/webhooks.mdx b/guides/webhooks.mdx index f57afe1..8b10ccb 100644 --- a/guides/webhooks.mdx +++ b/guides/webhooks.mdx @@ -1,6 +1,6 @@ --- title: "Webhooks for job events" -description: "Receive job status events via signed HMAC POST. Setup, payload format, signature verification, 3-attempt retry policy. Available on all plans." +description: "Receive job status events via signed HMAC POST. Setup, payload format, signature verification, 3-attempt retry policy." sidebarTitle: "Webhooks" icon: "bell" keywords: ["webhooks", "hmac signature", "job status webhook", "rendobar webhook setup", "signed webhook"] @@ -25,7 +25,7 @@ canonical: "https://rendobar.com/docs/guides/webhooks" }} /> -Rendobar POSTs JSON to your endpoint when a [job](/concepts/job) changes status. Available on all plans, including Free. +Rendobar POSTs JSON to your endpoint when a [job](/concepts/job) changes status. ## Set up a webhook diff --git a/jobs/compose.mdx b/jobs/compose.mdx index 3f8277d..cb60282 100644 --- a/jobs/compose.mdx +++ b/jobs/compose.mdx @@ -1,7 +1,7 @@ --- title: "Compose: render from a timeline" sidebarTitle: "Compose" -description: "Render a video from a declarative JSON timeline. Tracks, clips, transitions, text, and per-clip effects, in one API call." +description: "Render a video from a declarative JSON timeline. Tracks, clips, transitions, text, and per-clip effects." icon: "film" keywords: ["video compose api", "json timeline to video", "video transitions api", "video editing api", "compose"] canonical: "https://rendobar.com/docs/jobs/compose" @@ -15,7 +15,7 @@ canonical: "https://rendobar.com/docs/jobs/compose" "@type": "TechArticle", "@id": "https://rendobar.com/docs/jobs/compose/#article", "headline": "Compose: render from a timeline", - "description": "Render a video from a declarative JSON timeline. Tracks, clips, transitions, text, and per-clip effects, in one API call.", + "description": "Render a video from a declarative JSON timeline. Tracks, clips, transitions, text, and per-clip effects.", "datePublished": "2026-06-21", "dateModified": "2026-06-22", "author": { "@type": "Organization", "@id": "https://rendobar.com/#organization" }, @@ -29,7 +29,7 @@ canonical: "https://rendobar.com/docs/jobs/compose" ## Your simplest render -The smallest timeline is one track with one clip. This trims three seconds of a video and renders it to MP4. The whole API call: +The smallest timeline is one track with one clip. This renders the first three seconds of a video to MP4. The whole API call: @@ -54,8 +54,7 @@ const job = await client.jobs.create({ { asset: { type: "video", - src: "https://cdn.rendobar.com/assets/examples/a.mp4", - trim: { from: 0, to: 3 }, + src: "https://cdn.rendobar.com/assets/examples/sample.mp4", }, start: 0, length: 3, @@ -93,8 +92,7 @@ res = requests.post( { "asset": { "type": "video", - "src": "https://cdn.rendobar.com/assets/examples/a.mp4", - "trim": {"from": 0, "to": 3}, + "src": "https://cdn.rendobar.com/assets/examples/sample.mp4", }, "start": 0, "length": 3, @@ -128,8 +126,7 @@ curl -X POST https://api.rendobar.com/jobs \ { "asset": { "type": "video", - "src": "https://cdn.rendobar.com/assets/examples/a.mp4", - "trim": { "from": 0, "to": 3 } + "src": "https://cdn.rendobar.com/assets/examples/sample.mp4" }, "start": 0, "length": 3 @@ -148,6 +145,8 @@ curl -X POST https://api.rendobar.com/jobs \ **Assets:** video, image, text, audio, composition ยท **Output:** mp4 / webm / gif / mp3 (audio only) / jpg / png (still frame) +Without `trim`, a clip plays its source from the start for `length` seconds. To use a specific segment instead, add `trim: { from, to }` (in source seconds) to the asset. `length` is always the timeline duration. `trim` only chooses which part of the source fills it. + That is the shape of every render. Everything below is one more clip, one more track, or one more field. ## Join two clips diff --git a/support/faq.mdx b/support/faq.mdx index 3cbde93..71ba129 100644 --- a/support/faq.mdx +++ b/support/faq.mdx @@ -45,7 +45,7 @@ canonical: "https://rendobar.com/docs/support/faq" "name": "Can I drive Rendobar from an AI agent?", "acceptedAnswer": { "@type": "Answer", - "text": "Yes. Connect any MCP-compatible agent to https://api.rendobar.com/mcp with your API key. Six typed MCP tools (submit_job, get_job, list_jobs, probe_media, get_account, upload_media). Available on all plans." + "text": "Yes. Connect any MCP-compatible agent to https://api.rendobar.com/mcp with your API key. Six typed MCP tools (submit_job, get_job, list_jobs, probe_media, get_account, upload_media)." } }, { @@ -108,7 +108,7 @@ canonical: "https://rendobar.com/docs/support/faq" - Yes. Connect any MCP-compatible agent to `https://api.rendobar.com/mcp` with your API key. Six typed MCP tools: `submit_job`, `get_job`, `list_jobs`, `probe_media`, `get_account`, `upload_media`. Available on all plans. See [MCP overview](/mcp-server). + Yes. Connect any MCP-compatible agent to `https://api.rendobar.com/mcp` with your API key. Six typed MCP tools: `submit_job`, `get_job`, `list_jobs`, `probe_media`, `get_account`, `upload_media`. See [MCP overview](/mcp-server).