---
title: "Get one move's program and readable text"
method: POST
path: "/api/get_move"
---

# Get one move's program and readable text

`POST /api/get_move`

## Request

- Base URL: `https://jabbertoon.com`
- URL: `https://jabbertoon.com/api/get_move`
- Auth: none required

Returns one ready-made move: its block program as JSON, the same program as screenplay text, its length in seconds, what it works on, its settings with units, its page and links. Name it by id (c4c:beh:wave_hello), short name (wave_hello) or page slug. To write your own move, start from one, change it, then validate it. Example: {"move": "wave_hello"}.

## Request body

- object
  - `move` string, required: Its id, short name or page slug, as list_moves gives them.

## Response `200`

What get_move answers. ok is false when what you sent has problems; they are listed with where, says and fix.

- object
  - `ok` boolean, required
  - `url` string, required: The move's page on jabbertoon.com (the list of moves when the move is not found).
  - `id` string
  - `slug` string
  - `pack_slug` string
  - `name` string
  - `description` string
  - `seconds` number, nullable
  - `skeleton` boolean
  - `version` string
  - `license` string
  - `content_hash` string
  - `works_on` object
  - `suits` string[]
  - `params` unknown[]: The settings a does block can give it, each with its unit, default and what it does.
    - unknown
  - `links` object
  - `program` object: The move's block program (JSON).
  - `text` string: The same program as screenplay text, one block per line.
  - `engine` Engine
    - `version` string: The block language's version.
    - `git` string: The git tree id of the engine that answered (the same on every door).
  - `notes` string[]
  - `error` Problem
    - `code` string, required
    - `where` string, nullable, required
    - `says` string, required
    - `fix` string, nullable, required
    - `url` string: The code's entry on https://jabbertoon.com/docs/errors/.
    - `did_you_mean` string[]
    - `patch` object[]: RFC 6902 operations on what you sent that make the fix, given only when the fix is certain.

## Other responses

- `4XX`: 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).
- `5XX`: 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).

---

[API](https://skmtc.dev/jabbertoon/apis/jabbertoon-tools-for-ai-assistants-and-developers.md) · [All operations](https://skmtc.dev/jabbertoon/apis/jabbertoon-tools-for-ai-assistants-and-developers/llms.txt) · [OpenAPI document](https://skmtc.dev/jabbertoon/apis/jabbertoon-tools-for-ai-assistants-and-developers/revisions/004970e97459?raw)