> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eversince.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# compose motion

> Place a motion graphic on its own visual track over the stack, from Remotion JSX or from a template, or rewrite the graphic on clip_id in place, keeping its lane, timing and settings. Code: a component named DynamicAnimation, plain JSX, no imports, against the fixed runtime scope and CONTROLS convention skill-motion-graphics lists (manage_skills get), animated from useCurrentFrame (rendering is frame-deterministic). template places a ready graphic or one saved in this workspace; save_as keeps what this call made under a name. The response says what it made and what compiles but is wrong. No frame is drawn: inspect_timeline shows the result. Free.



## OpenAPI

````yaml /openapi.json post /tools/compose_motion
openapi: 3.1.0
info:
  title: Eversince API
  version: '1'
  description: >-
    Every Eversince tool as one POST call, plus the routes beside them: the tool
    list, account and keys, uploads, webhooks and models. The prose is at
    https://docs.eversince.ai.
servers:
  - url: https://eversince.ai/api/v1
security:
  - bearer: []
tags:
  - name: Discovery
    description: The tool list, the same on the MCP server, the REST API and the CLI.
  - name: Workspace
    description: Jobs, balances, settings, templates, skills and the overview.
  - name: Library
    description: >-
      Items, search, import, reading media, comments, boards, calendars, the
      brand kit and public links.
  - name: Timeline
    description: 'Video editing: timelines, clips, captions, sound, language and rendering.'
  - name: Canvas
    description: 'Still editing: canvases, slides, layers and rendering.'
  - name: Generation
    description: Image, video and audio generation, upscaling, cutouts and models.
  - name: Research
    description: 'What platforms publish: pulling and keeping posts.'
  - name: Account
    description: Balances, keys, workspaces and script sessions.
  - name: Uploads
    description: Files into the library by presigned upload or by URL.
  - name: Webhooks
    description: Job results posted to a URL as they complete.
  - name: Models
    description: Generation models and cost estimates.
paths:
  /tools/compose_motion:
    post:
      tags:
        - Timeline
      summary: compose motion
      description: >-
        Place a motion graphic on its own visual track over the stack, from
        Remotion JSX or from a template, or rewrite the graphic on clip_id in
        place, keeping its lane, timing and settings. Code: a component named
        DynamicAnimation, plain JSX, no imports, against the fixed runtime scope
        and CONTROLS convention skill-motion-graphics lists (manage_skills get),
        animated from useCurrentFrame (rendering is frame-deterministic).
        template places a ready graphic or one saved in this workspace; save_as
        keeps what this call made under a name. The response says what it made
        and what compiles but is wrong. No frame is drawn: inspect_timeline
        shows the result. Free.
      operationId: compose_motion
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/WorkspaceId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                timeline_id:
                  type: string
                  description: The timeline id.
                source_code:
                  description: >-
                    Remotion JSX source (the server compiles it; never pass
                    compiled code). Leave out when placing a template, or when
                    only saving the graphic already on clip_id.
                  type: string
                template:
                  description: >-
                    Place this instead of source_code: a graphic saved in this
                    workspace (name or id), with its saved settings and length,
                    or a ready graphic by the id get_templates returns. The code
                    is then the clip's own.
                  type: string
                  maxLength: 120
                values:
                  description: >-
                    Knob values by CONTROLS name, set on the clip with the code:
                    words, colors, a picture knob's library ref. Over a template
                    they change only what they name.
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties:
                    anyOf:
                      - type: string
                      - type: number
                      - type: boolean
                save_as:
                  description: >-
                    Save the graphic this call leaves on the timeline under this
                    name for the workspace, its code, settings and length
                    together; an existing name is overwritten. With clip_id and
                    nothing else, saves that clip as it is.
                  type: string
                  maxLength: 60
                clip_id:
                  description: >-
                    Rewrite the graphic on this clip instead of adding another.
                    It keeps its place, its length, its lane and its fades, and
                    the knobs a user has turned stay turned. This is how a
                    graphic is revised.
                  type: string
                placement:
                  description: >-
                    Where a new clip lands: { from (frame, default 0),
                    duration_frames (default the saved graphic's length, else
                    three seconds) }, or from_seconds and duration_seconds. Each
                    call adds its own overlay lane. Not with clip_id.
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties: {}
                props:
                  description: >-
                    Only description is read, as the clip's label. Values live
                    in the source; the ones worth changing later go in its
                    CONTROLS list, set with values here or later with
                    edit_timeline updateClip {values}.
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties: {}
                context:
                  description: 'Optional: one sentence shown to the user beside this action.'
                  type: string
                  maxLength: 600
              required:
                - timeline_id
      responses:
        '200':
          description: >-
            Done, or a job started for work that runs longer (follow it with
            get_jobs).
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                  - data
                  - meta
                properties:
                  ok:
                    const: true
                  data:
                    type: object
                    additionalProperties: true
                  meta:
                    type: object
                    properties:
                      request_id:
                        type: string
                      cost:
                        $ref: '#/components/schemas/Cost'
                      cloud_processing:
                        $ref: '#/components/schemas/CloudProcessing'
                  media:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
      description: >-
        Retry a paid dispatch safely: the same key returns the job already
        dispatched instead of charging again.
    WorkspaceId:
      name: x-workspace-id
      in: header
      required: false
      schema:
        type: string
      description: The workspace this one call acts in, when it is not the key's own.
  schemas:
    Cost:
      type: object
      description: AI credits the call cost.
      additionalProperties: true
    CloudProcessing:
      type: object
      description: Cloud processing the call used, and what is left.
      properties:
        ran_on:
          const: cloud
        minutes:
          type: number
        queued_minutes:
          type: number
        left_minutes:
          type: number
        bought_minutes:
          type: number
        note:
          type: string
    Error:
      type: object
      required:
        - ok
        - error
      properties:
        ok:
          const: false
        error:
          type: object
          required:
            - code
            - message
            - retryable
          properties:
            code:
              type: string
            message:
              type: string
              description: What went wrong, in words to act on.
            retryable:
              type: boolean
            suggested_action:
              type: string
              description: The next step that works.
            cloud_processing:
              $ref: '#/components/schemas/CloudProcessing'
  responses:
    Error:
      description: The call was refused or failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        An API key (es_live_…) from Settings, under API keys, or an OAuth access
        token.

````