Activities

Read one API activity

One retained safe summary. Current computer access and the row’s recorded account/workspace scope are checked again. Missing, expired, deleted and outside-scope rows answer the same 404. No output or guest files are read. No query parameters are accepted.

Requires the member role or higher.

get/computers/{id}/activities/{activity}

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/computers/{id}/activities/{activity}
  • Auth: HTTP bearer

Path parameters

idstring required

The computer id.

activitystring required

An activity_id from GET /computers/{id}/activities (act_ followed by 32 lowercase hex characters).

Response

Safe activity metadata only; never raw execution content. Responses are no-store.

activity_idstring required

Immutable activity ID; a request identity, never an execution idempotency key.

account_idstring required
computer_idstring required
workspace_idstring nullable required

The actual workspace when the request was admitted.

channel'api' | 'session-api' | 'managed-agent' required

Who sent the request. api: an API key, or a connected app acting through one. session-api: the dashboard, signed in. managed-agent: a hosted agent run — its summary row (action agent), and a row for each input or bash command it sent to the desktop.

route'input' | 'exec' | 'window' | 'clipboard' | 'agent' required
action'agent' | 'input' | 'move' | 'click' | 'button-down' | 'button-up' | 'drag' | 'scroll' | 'type' | 'paste' | 'key' | 'hold-key' | 'exec' | 'background-exec' | 'window' | 'focus' | 'raise' | 'minimize' | 'maximize' | 'unmaximize' | 'close' | 'window-move' | 'resize' | 'clipboard' required
state'pending' | 'acknowledged' | 'exited' | 'accepted' | 'refused' | 'unknown' required
received_atstring required

Control-plane receipt time, UTC.

observed_atstring required

Control-plane observation time, UTC.

revisioninteger

Monotonic row revision, including late result links. Does not change action observation time.

has_resultsboolean

Small link hint; expand the passive results detail for current availability.

fundedboolean

Present on managed-agent run summaries: whether the run used account AI credits.

cost_usdnumber

Total funded AI charge on a managed-agent run summary. Zero for BYOK, whose model bill is external.

dispatched_atstring

First physical eligible transport attempt, when observed. Does not prove guest execution.

elapsed_msinteger

Monotonic request elapsed time, including network and admission; not guest execution duration.

reason'body-too-large' | 'invalid-body' | 'local-refusal' | 'transport' | 'unclassified' | 'invalid-result' | 'result-too-large' | 'wait-ended' | 'pending-expired'
http_statusinteger

Known response status. A dispatched error does not prove the action had no effect.

exit_codeinteger

Present only for a known synchronous command exit, including signed failures. Timeout sentinel values are omitted.

execution_idstring

Optional immutable execution ID returned by the original request; never inferred from PID. No output is fetched to populate history.

Changes

No recorded changes to this operation across all 1 revision of this API.