API

heic-convert

Runs in your own browser: we issue a work order, your agent opens the tool page and follows `recipe`, and the run settles when the converted file is saved. The photo never passes through our servers. Useful for iPhone photos, which arrive as HEIC and are rejected by most pipelines.

Call it

POST https://timbrica.com/v1/tools/heic-convert/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <your retry-safe key>
Content-Type: application/json

Input

Browser recipe

This tool runs in your own browser. The work order you receive carries this recipe with the placeholders filled in; the selectors below are a versioned contract, not implementation detail — they do not change without a version bump.

{
    "engine": "dom",
    "steps": [
        {
            "action": "upload",
            "selector": "[data-tmb-api=\"input-file\"]",
            "accept": [
                ".heic",
                ".heif"
            ]
        },
        {
            "action": "select",
            "selector": "[data-tmb-api=\"format\"]",
            "value": "{{format}}"
        },
        {
            "action": "click",
            "selector": "[data-tmb-api=\"run\"]"
        },
        {
            "action": "wait",
            "selector": "[data-tmb-api=\"download\"]",
            "timeout_s": 120,
            "appears": "after_run"
        },
        {
            "action": "click",
            "selector": "[data-tmb-api=\"download\"]",
            "appears": "after_run"
        }
    ],
    "result": {
        "kind": "download",
        "settles": "automatically"
    }
}

Errors it can return

validation_failed  insufficient_tokens 

History

• v1 — 2026-07-30 — Initial release (browser lane).

This contract cannot change without a new version and a line above: a test compares the published schema, pricing and limits against a committed lockfile and fails the build otherwise. Subscribe to /v1/changelog to be told when something moves.