Skip to content
Sign InDashboard
Tools

list_clips

Connect in ChatGPT

The clips Heavenly found, best first: id, title, start/end, a 0-100 virality score with sub-scores, the reasons it was picked, the hook line, and a ready-to-post preview MP4 link (valid about an hour).

Access token · read · Read only

Parameters

job_id string required

The Clips job id (from clip_video or list_clip_jobs).

View schema
job_id schema
{
  "description": "The Clips job id (from clip_video or list_clip_jobs).",
  "type": "string",
  "format": "uuid",
  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
}

Request example

Tool request · example
{
  "name": "list_clips",
  "arguments": {
    "job_id": "00000000-0000-4000-8000-000000000001"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.