Automation REST API
Human typing
Send text to a running profile as keystrokes rather than as a paste.
Read the 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
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 |
|---|---|---|
idrequired | string | The record’s id. |
Body
| Field | Type | What it is |
|---|---|---|
textrequired | 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 —
textis 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.