> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usealmanac.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Follow a job

> Observe ingest or Garden work from queue to final outcome.

Uploads and Garden runs create hosted jobs. A job has a stable ID, status, event
history, human summary, and outcome.

## Wait for completion

Immediately after an interactive upload:

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
almanac jobs wait last
```

```text theme={"theme":{"light":"github-light","dark":"vesper"}}
job_123  ingest  succeeded  completed  wrote 6 pages
```

`last` resolves to the newest job in the selected wiki. SDK and API writes return
a nullable job record whose ID can be retained for exact waiting. CLI uploads do
not currently expose that ID, so serialize CLI writes and wait immediately.

## Choose the view you need

| Goal                       | Command                       |
| -------------------------- | ----------------------------- |
| List recent jobs           | `almanac jobs`                |
| Read final state           | `almanac jobs show job_123`   |
| Read recorded events       | `almanac jobs events job_123` |
| Stream new events          | `almanac jobs tail job_123`   |
| Block until terminal state | `almanac jobs wait job_123`   |

## Investigate a failure

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
almanac jobs show job_123
almanac jobs events job_123
```

Start with the final error and the last recorded event. If a job remains queued
or running unexpectedly, include its ID when asking for help. See
[Troubleshooting](/reference/troubleshooting) for common auth, scope, upload, and
job symptoms.

<Card title="Next: search the updated wiki" icon="search" href="/guides/search-read">
  Find the pages written by the successful job.
</Card>