Jabbertoon Share Link API

openapi: 3.2.0
info:
  title: Jabbertoon tools for AI assistants and developers Share…
  version: '1'
  summary: Read Jabbertoon's guide, moves, characters and looks, check a cartoon, a move or a character you write, and make a jabbertoon.com link that opens a move or a character, or the cartoon in the studio.
  description: 'The same tools as Jabbertoon''s MCP server (https://jabbertoon.com/mcp), over plain HTTP. No key and no account. GET answers the read tools whose arguments are plain values; POST a JSON object of arguments to any tool. Nothing sent to validate or share_link is stored or logged; report_problem keeps its report for a person to read. Errors are {code, where, says, fix, url}, with did_you_mean and an RFC 6902 patch when the fix is certain. Making the video is done on your own computer, by the jabbertoon tool (preview, render_video). The block language: https://jabbertoon.com/docs/language/'
  contact:
    name: Jabbertoon
    email: hello@jabbertoon.com
    url: https://jabbertoon.com/for-ai/
  license:
    name: Proprietary, 1211 Holding LLC
    url: https://jabbertoon.com/license/
servers:
- url: https://jabbertoon.com
security: []
tags:
- name: Share Link
paths:
  /api/share_link:
    post:
      operationId: share_link
      summary: Make a jabbertoon.com link that opens a cartoon, a move or a character
      description: 'Turns a cartoon, a scene, a move or a character into a jabbertoon.com link: it opens in the editor (a move in its move maker). It all travels after the #: nothing is uploaded or kept. All but a character''s end with &from=ai (the page says an AI helper wrote it). One with errors gets them instead. Give one of cartoon, program, character or file. Example: {"program": {"v": 1, "kind": "behaviour", "scripts": [{"body": [{"op": "hop"}]}]}}.'
      security: []
      responses:
        '200':
          description: What share_link answers. ok is false when what you sent has problems; they are listed with where, says and fix.
          content:
            application/json:
              schema:
                type: object
                required:
                - ok
                - url
                properties:
                  ok:
                    type: boolean
                  url:
                    type: string
                    description: The jabbertoon.com page the link opens.
                  kind:
                    type:
                    - string
                    - 'null'
                    description: behaviour, scene, cartoon or character.
                  link:
                    type: string
                    description: The link to give the person.
                  links:
                    type: object
                    description: Every page that opens it, the editor's first.
                  code:
                    type: string
                    description: 'The share code after #c=: "1.", base64url of the raw DEFLATE of the UTF-8 canonical JSON, ".", base64url of its CRC-32.'
                  length:
                    type: integer
                    description: The link's length in characters.
                  errors:
                    type: array
                    items:
                      $ref: '#/components/schemas/Problem'
                    description: 'The errors, in order: the first 50 at most (error_count says how many there are).'
                  error_count:
                    type: integer
                    description: How many errors the checks found.
                  warnings:
                    type: array
                    items:
                      $ref: '#/components/schemas/Problem'
                    description: 'The warnings, in order: the first 50 at most (warning_count says how many there are).'
                  warning_count:
                    type: integer
                    description: How many warnings the checks found.
                  engine:
                    $ref: '#/components/schemas/Engine'
                  notes:
                    type: array
                    items:
                      type: string
                  error:
                    $ref: '#/components/schemas/Problem'
        4XX:
          $ref: '#/components/responses/Problem'
        5XX:
          $ref: '#/components/responses/Problem'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cartoon:
                  type:
                  - object
                  - string
                  description: Its program, a cartoon file {cast, places?, program}, or its screenplay text (read on your own computer only).
                program:
                  type: object
                  description: A move (kind "behaviour"), a scene or a cartoon program.
                character:
                  type: object
                  description: Your own character, {"name", "content"}, or a character pack.
                file:
                  type: string
                  maxLength: 255
                  description: 'On your own computer only: a file''s name in the output folder.'
              minProperties: 1
              maxProperties: 1
              additionalProperties: false
            example:
              program:
                v: 1
                kind: behaviour
                name: Happy bob
                scripts:
                - body:
                  - op: bob
                    amp: 12
                  - op: swingPart
                    part: arms
                    deg: 30
      tags:
      - Share Link
components:
  schemas:
    Problem:
      type: object
      required:
      - code
      - where
      - says
      - fix
      properties:
        code:
          type: string
        where:
          type:
          - string
          - 'null'
        says:
          type: string
        fix:
          type:
          - string
          - 'null'
        url:
          type: string
          description: The code's entry on https://jabbertoon.com/docs/errors/.
        did_you_mean:
          type: array
          items:
            type: string
        patch:
          type: array
          items:
            type: object
          description: RFC 6902 operations on what you sent that make the fix, given only when the fix is certain.
    Engine:
      type: object
      properties:
        version:
          type: string
          description: The block language's version.
        git:
          type: string
          description: The git tree id of the engine that answered (the same on every door).
  responses:
    Problem:
      description: 'A request the server cannot use (400 bad_arguments, 404 not_found, 405, 413 too_large, 415, 503 busy or timeout: try again after Retry-After).'
      content:
        application/json:
          schema:
            type: object
            required:
            - ok
            - url
            - error
            properties:
              ok:
                const: false
              url:
                type: string
              error:
                $ref: '#/components/schemas/Problem'
externalDocs:
  description: 'Developers: quickstart in curl, Python and JavaScript'
  url: https://jabbertoon.com/developers/
x-mcp:
  url: https://jabbertoon.com/mcp
  transport: streamable-http