---
title: "Get the current or last known install job status for a system target"
method: GET
path: "/api/v1/system/install/{target}"
tags: ["system"]
---

# Get the current or last known install job status for a system target

`GET /api/v1/system/install/{target}`

## Path parameters

- `target` string, required — Install target identifier: tmux, gh, claude, codex, opencode, or copilot.

## Response `200`

OK

- InstallJob
  - `command` string — Human-readable install command, e.g. "brew install tmux", for display even before/without output.
  - `error` string — Set on failure or when the target is unsupported on this machine: the exec error, the Unsupported reason, or a timeout message.
  - `finishedAt` string, date-time, nullable — Absent until the job finishes.
  - `output` string — Combined stdout+stderr from the install command, tail-capped to the last ~4000 bytes.
  - `startedAt` string, date-time, nullable
  - `status` 'idle' | 'running' | 'succeeded' | 'failed' | 'unsupported', required — Current lifecycle state of the job.
  - `target` 'tmux' | 'gh' | 'claude' | 'codex' | 'opencode' | 'copilot', required — Install target this job ran (or is running) for.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error
- `501` — Not Implemented

---

[API](https://skmtc.net/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.net/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/agent-orchestrator-http-daemon/revisions/ddec88a09a83/schema)