Control

Read execution metadata

Reads daemon memory only, without guest commands, files, watcher setup or automatic resume. Only background exec participates; synchronous results have no retrievable execution ID yet. The ID comes from the 202 response and both exited/lost process.exited payloads. IDs cannot resolve to a replacement command when a PID is reused. Current computer scope and the original execution scope must both match. No command text or output is included. Handles are ephemeral: daemon restart, computer removal, PID replacement or cleanup makes an ID unavailable. Observed exits expire after ten minutes. Unknown and expired IDs both return 404 with code execution_unavailable, never an empty successful result. A computer outside the caller’s scope returns 404 computer not found with no code. Lost may be observed briefly before the handle is removed.

Requires the member role or higher.

get/computers/{id}/executions/{executionId}

Request

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

Path parameters

idstring required

The computer id.

executionIdstring required

The opaque execution_id from a backgrounded exec (exec_ followed by 32 lowercase hex characters).

Response

Last known daemon metadata; no guest work.

execution_idstring required

Opaque background execution ID. An identifier, never authorization.

computer_idstring required

The computer this execution belongs to.

pidinteger required

Guest PID, which may be reused; identify results by execution_id.

status'running' | 'lost' | 'exited' required

Last daemon observation. Running does not imply the computer is awake; lost has no known exit code.

started_atstring required

Daemon acceptance time, RFC 3339.

ended_atstring

Observed exit time, RFC 3339; absent unless exited.

exit_codeinteger

Present only for an observed exit. This is not task success.

output_source'volatile_guest_files' required

Guest output is mutable and ephemeral, not retained history.

Changes

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