§ REST
REST API
A loopback HTTP adapter on 127.0.0.1:45831. Off by default. Enable in Settings › REST 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
- 01
Open Settings › REST API
Find the Enable local REST API toggle.
Settings › REST API
- 02
Toggle the server on
The status flips to Running. Base URL: http://127.0.0.1:45831.
- 03
Copy the token
Click Copy Token. Send it as `Authorization: Bearer <token>`.
- 04
Test with the bundled curl
Click Copy Health curl. Paste into your terminal. Confirm 200.
Example: health + latest transcript ref
# Health
curl http://127.0.0.1:45831/v1/system/health \
-H "Authorization: Bearer $DETTIVO_IPC_TOKEN"
# Latest transcript ref
curl "http://127.0.0.1:45831/v1/transcripts/latest?kind=any" \
-H "Authorization: Bearer $DETTIVO_IPC_TOKEN"Token lookup order
The same token can also be read by the bundled CLI and MCP server. Lookup order: $DETTIVO_IPC_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.
Just launched
Just launched on your Mac.
One-time license, three active Macs, lifetime updates. $45 once, forever yours.