Tools

create_motion_followup

Refine a design that is completed, or answer the question of one that is awaiting_user_input. It starts a new job (same cost as a first one) that keeps the earlier design's shape and look unless you set them again, and leaves the earlier result untouched.

Access token · edit · Changes account data

Parameters

prompt string required

View schema

{
  "type": "string",
  "minLength": 1,
  "maxLength": 12000
}

aspect_ratio string optional

View schema

{
  "type": "string",
  "enum": [
    "16:9",
    "9:16",
    "1:1",
    "4:5"
  ]
}

duration string optional

View schema

{
  "type": "string",
  "enum": [
    "<10s",
    "10-30s",
    "30s-1min",
    "1-5min"
  ]
}

design_system_id string optional

View schema

{
  "type": "string",
  "enum": [
    "heavenly",
    "editorial",
    "mono",
    "neon",
    "sunset",
    "ocean",
    "forest",
    "paper",
    "broadcast",
    "playful"
  ]
}

design_md string optional

Optional: a DESIGN.md as text. Takes precedence over design_system_id.

View schema

{
  "description": "Optional: a DESIGN.md as text. Takes precedence over design_system_id.",
  "type": "string",
  "maxLength": 60000
}

style_reference_url string optional

View schema

{
  "type": "string",
  "maxLength": 4096
}

attachments array optional

View schema

{
  "maxItems": 100,
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "maxLength": 4096
      },
      "name": {
        "type": "string",
        "maxLength": 240
      },
      "type": {
        "type": "string",
        "enum": [
          "image",
          "video",
          "audio",
          "file"
        ]
      },
      "content_type": {
        "type": "string",
        "maxLength": 120
      }
    },
    "required": [
      "url"
    ],
    "additionalProperties": false
  }
}

jobId string required

The design's job id (from create_motion_design or list_motion_designs).

View schema

{
  "description": "The design's job id (from create_motion_design or list_motion_designs).",
  "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

{
  "name": "create_motion_followup",
  "arguments": {
    "prompt": "YOUR_PROMPT",
    "jobId": "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.