# Human typing: Mosaic API reference

> Human typing in Mosaic’s local REST API: 2 routes, each with its method, path, fields, what it returns and the errors it names.

Source: https://mosaicbrowser.com/docs/api/typing

**Automation** REST API

## Human typing

Send text to a running profile as keystrokes rather than as a paste.

- [GETRead the typing defaults](#typing-defaults)
- [POSTType into a running profile](#type-text)

## [Read the typing defaults](#typing-defaults)

GET`/api/v1/typing/defaults`

The speed, mistake rate and pause behaviour used when a request passes no options.

#### Returns

A `TypingOptions`.

## [Type into a running profile](#type-text)

POST`/api/v1/profiles/:id/type`

Types the text into whatever the profile’s focused page has focused, one character at a time, through the same input pipeline a real key press uses — so the page receives `keydown`, `keypress`, `input` and `keyup` for every character. A paste, by contrast, is a single event with `inputType: "insertFromPaste"` and no key presses at all, which is one of the clearest automation tells a hardened login can look for. Gaps between keystrokes are right-skewed rather than uniform, punctuation and shifted characters cost more, and mistakes are typed then corrected with a backspace. The call blocks for as long as the typing takes.

#### Path parameters

| Field | Type | What it is |
| --- | --- | --- |
| `id`required | `string` | The record’s id. |

#### Body

| Field | Type | What it is |
| --- | --- | --- |
| `text`required | `string` | What to type. Newlines are sent as Enter. |
| `options.charactersPerMinute` | `number` | Mean speed. 200–400 is ordinary; 500+ is a fast typist. Default 320. |
| `options.typoRate` | `number` | Chance per character of a wrong neighbouring key that is then corrected, 0–0.1. Default 0.015. |
| `options.thinkingPauses` | `boolean` | Occasional long pauses, as if reading. Default true. |

#### Returns

`{ typed, seconds }`

#### Errors

- 400 — `text` is missing.
- 400 — the profile is not running; there is nothing to type into.

## Run the API on your own profiles

The REST API and the MCP server are part of Pro: $49 a month, with the first 14 days free. Free has every browser feature and no API key.

Mosaic is a desktop app

Email yourself the link and open it on your computer.