> ## 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.

# get templates

> The catalogue Explore shows: ready motion graphics, caption templates, camera moves, photo and video filters, the font catalogue, the graphics and caption templates saved in this workspace, and its timeline and canvas templates. id (as copied in Explore or returned by a listing) returns what it is and the exact call that uses it: a graphic with its controls and, with code, its source; a template with its holes and, for shelf templates, its pictures; ids reads several in one call. query searches, kind or shelf browses, and nothing returns the kinds and shelves. Read only. Free.



## OpenAPI

````yaml /openapi.json post /tools/get_templates
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/get_templates:
    post:
      tags:
        - Workspace
      summary: get templates
      description: >-
        The catalogue Explore shows: ready motion graphics, caption templates,
        camera moves, photo and video filters, the font catalogue, the graphics
        and caption templates saved in this workspace, and its timeline and
        canvas templates. id (as copied in Explore or returned by a listing)
        returns what it is and the exact call that uses it: a graphic with its
        controls and, with code, its source; a template with its holes and, for
        shelf templates, its pictures; ids reads several in one call. query
        searches, kind or shelf browses, and nothing returns the kinds and
        shelves. Read only. Free.
      operationId: get_templates
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/WorkspaceId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  description: >-
                    The id the user copied in Explore, or one a listing
                    returned.
                  type: string
                ids:
                  description: >-
                    Several ids in one call: entries returns each in the order
                    given, a miss reported beside its id. An answer stops at
                    about 100,000 characters and names the rest in next_ids.
                  minItems: 1
                  maxItems: 20
                  type: array
                  items:
                    type: string
                query:
                  description: >-
                    Words for what is needed: "lower third with a photo".
                    Returns the closest matches.
                  type: string
                kind:
                  description: >-
                    One kind: graphic (alone it lists the shelves), caption,
                    move (camera moves), timeline (video templates, ours then
                    this workspace's), canvas (image templates, ours then this
                    workspace's), filter, font (every family the renderer draws,
                    with its weights and scripts).
                  type: string
                  enum:
                    - graphic
                    - caption
                    - move
                    - timeline
                    - canvas
                    - filter
                    - font
                shelf:
                  description: >-
                    A graphics shelf by name, as a listing gives it: "Lower
                    thirds". Lists its graphics.
                  type: string
                code:
                  description: 'With a graphic''s id: include its source code.'
                  type: boolean
      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.

````