ACI API

Overview

The ACI API is the gateway surface for the Allternit Computer Interface (ACI). It forwards browser-automation requests to the ACU computer-use gateway (domains/computer-use/core) and adapts the upstream SSE event stream into a stable client contract. Use it to start intent-driven browser runs, stream progress, stop active runs, and approve or deny permission prompts. ACI runs are stateless across the gateway: the gateway drains the upstream event stream into an in-process replay buffer so clients can attach to /api/aci/stream/:id at any time and see the full history.

Base URL

Management and control endpoints:

https://api.allternit.com/api/aci

For local development:

http://127.0.0.1:8013/api/aci

Authentication

All ACI management routes require a valid bearer token via the platform auth middleware. See Authentication.

Endpoints

Method	Path	Description
`POST`	`/api/aci/run`	Start a new browser-automation run.
`GET`	`/api/aci/stream/:id`	SSE stream of run events (replay + live tail).
`POST`	`/api/aci/stop/:id`	Cancel an active run.
`POST`	`/api/aci/approve/:id?deny=true`	Approve or deny a pending permission prompt.

Start a run

POST /api/aci/run

Kicks off an intent-driven browser run in the ACU gateway. The gateway returns a sessionId that is also the run id for streaming, stopping, and approval.

Request body

Field	Type	Required	Description
`goal`	string	Yes	The task description for the browser run.
`model`	string	No	Override the model used for planning.
`allowedSites`	any	No	Allowed site list passed verbatim to ACU.
`autoVerify`	boolean	No	Whether ACU should auto-verify actions.
`openLinksInBrowser`	boolean	No	Open links inside the browser context.
`sessionPersistence`	any	No	Session persistence hint passed verbatim.

Example request

curl -X POST https://api.allternit.com/api/aci/run \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "goal": "Find the latest Allternit release notes",
    "model": "auto",
    "allowedSites": ["allternit.com"],
    "openLinksInBrowser": true
  }'

Example response

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "adapterId": "browser"
}

Stream run events

GET /api/aci/stream/:id

Returns a Server-Sent Events stream for the run. The stream replays buffered events, tails new events, and ends with a done frame. Runs started in the current gateway process are served from an in-process buffer; older runs fall back to proxying ACU’s events endpoint.

Stream frame types

Type	Description
`trace`	Human-readable progress message from ACU.
`state`	Structured state update from ACU.
`done`	Run ended.

Example curl

curl -N https://api.allternit.com/api/aci/stream/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: text/event-stream"

Example event

event: message
data: {"type":"trace","data":{"message":"Navigating to allternit.com","event_type":"browser.navigate","data":{}},"ts":1754541600000}

Stop a run

POST /api/aci/stop/:id

Cancels the run in ACU and returns the upstream response.

Example response

{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "cancelled"
}

Approve or deny a prompt

POST /api/aci/approve/:id
POST /api/aci/approve/:id?deny=true

Sends an approval decision for a permission prompt raised by the run. Omit deny or set it to false to approve; set deny=true to deny.

Example request

curl -X POST "https://api.allternit.com/api/aci/approve/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $TOKEN"

Example response

{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "decision": "approve"
}

Error codes

Status	Code	Meaning
`200 OK`	—	Request succeeded.
`400 Bad Request`	`goal is required`	Empty or missing `goal` in `/run`.
`401 Unauthorized`	—	Missing or invalid bearer token.
`502 Bad Gateway`	`acu_unavailable`	ACU gateway could not be reached.
`502 Bad Gateway`	`acu_error`	ACU returned a non-success status.
`404 Not Found`	—	Stream id not known and ACU has no events for it.

Overview

LLM Gateway

Agents & Runtime

Work Queue & Deployments

Files, Webhooks & Sandbox

Tools & Connectors

Collaboration & Workflows

Infrastructure & Platform

Canvases

Onboarding

A Labs

Playground

Users & Profiles

Overview

Base URL

Authentication

Endpoints

Start a run

Request body

Example request

Example response

Stream run events

Stream frame types

Example curl

Example event

Stop a run

Example response

Approve or deny a prompt

Example request

Example response

Error codes

​Overview

​Base URL

​Authentication

​Endpoints

​Start a run

​Request body

​Example request

​Example response

​Stream run events

​Stream frame types

​Example curl

​Example event

​Stop a run

​Example response

​Approve or deny a prompt

​Example request

​Example response

​Error codes

​Related pages

Overview

Base URL

Authentication

Endpoints

Start a run

Request body

Example request

Example response

Stream run events

Stream frame types

Example curl

Example event

Stop a run

Example response

Approve or deny a prompt

Example request

Example response

Error codes

Related pages