Get Runtime Log

Read a channel container's stdout/stderr, live or archived.

The runtime counterpart of get_deploy_log, which only covers the build/boot window: this reads a RUNNING app's ongoing output, and — once the container is gone (a blue-green redeploy removes it) — the archive the cell wrote at removal, so a crash is still diagnosable afterwards (RUNTIME.md). The status facts (status, exit code, OOM flag, restart count) ride on every reply, so omitting command is the "just tell me how it died" query.

POST, not GET, because command is a shell pipeline: URL- encoding one is hostile, and a query string lands in Caddy's access log (and thus xhost_stats), where a grep <secret> must never go.

Auth mirrors get_deploy_log deliberately: bearer + channel ownership + the deploy:* scope both deploy-plane reads carry. The command grants the caller no authority they lack — a read-only copy of their own log inside a networkless disposable container — so resource abuse is answered by the cell's caps, not by a permission bit, and an owner-only gate would break sharing asymmetrically against get_deploy_log.

post/apps/{app_id}/channels/{channel_id}/runtime/log

Request

  • Base URL: https://api.xhostd.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.xhostd.com/apps/{app_id}/channels/{channel_id}/runtime/log
  • Auth: none declared

Path parameters

app_idstring uuid required
channel_idstring uuid required

Headers

authorizationstring nullable

Request body

container_indexinteger nullable
commandstring nullable

Response

Successful Response

container_indexinteger required
container_idstring required
container_namestring required
runningboolean required
source'live' | 'archive' required
statusstring required
exit_codeinteger nullable required
oom_killedboolean nullable required
restart_countinteger nullable required
started_atstring nullable required
finished_atstring nullable required
available_indicesinteger[] required
running_indexinteger nullable required
log_bytesinteger required
outputstring required
command_exit_codeinteger nullable required
timed_outboolean required
truncatedboolean required

Changes

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