Dettivo
Get notified

§ REST

REST API

Developer toolOpt-inLocal-only

A loopback HTTP adapter on 127.0.0.1:45831. Off by default. Enable in Settings › Developer API. Bearer token required. Maps every IPC operation to a JSON HTTP endpoint. Streaming import/export endpoints for long jobs.

Who this is for

Developers scripting Dettivo from non-Swift languages. Anyone who prefers HTTP semantics over CLI invocations. Anyone integrating Dettivo into a local web tool.

Enable + authenticate

  1. 01

    Open Settings › Developer API

    Find the Enable local REST API toggle.

    Settings › Developer API

  2. 02

    Toggle the server on

    The status flips to Running. Base URL: http://127.0.0.1:45831.

  3. 03

    Copy the token

    Click Copy Token. Send it as `Authorization: Bearer <token>`.

  4. 04

    Test with the bundled curl

    Click Copy Health curl. Paste into your terminal. Confirm 200.

Example: health + latest transcript

# Health
curl http://127.0.0.1:45831/v1/health \
  -H "Authorization: Bearer $DETTIVO_TOKEN"

# Latest transcript as markdown
curl http://127.0.0.1:45831/v1/transcripts/latest?format=markdown \
  -H "Authorization: Bearer $DETTIVO_TOKEN"

Token lookup order

The same token can also be read by the bundled CLI and MCP server. Lookup order: $DETTIVO_TOKEN environment variable, then Keychain (set automatically by the Settings pane), then ~/Library/Application Support/Dettivo/ipc.token file. Regenerate Token in Settings rotates all three.

§ Related

Launching April 2026

Be first on the launch list.

Dettivo opens for new purchases in April 2026. One-time license, three Macs, lifetime updates.