# jobs


Create or list jobs via the API

```bash
ittybit jobs [job_id] [flags]
```

List, inspect, or create jobs. Without arguments, lists recent jobs. With a job ID, shows details.

## List jobs

```bash
ittybit jobs
ittybit jobs \
  --kind video
ittybit jobs \
  --status failed
ittybit jobs \
  --limit 20
```

| Flag       | Description                                                      |
| ---------- | ---------------------------------------------------------------- |
| `--kind`   | Filter by job kind (`video`, `audio`, `image`, `adaptive_video`) |
| `--status` | Filter by status (`succeeded`, `failed`, etc.)                   |
| `--limit`  | Number of results (default 10)                                   |
| `--before` | Show jobs before this ID                                         |
| `--after`  | Show jobs after this ID                                          |

## Inspect a job

```bash
ittybit jobs job_01h455vb4pex5vsknk084sn02q
```

## jobs create

Create and run a job from a JSON body:

```bash
ittybit jobs create \
  --body '{"kind":"video","input":"input.mp4","options":{"format":"mp4"}}'
```

Or pipe from stdin:

```bash
echo '{"kind":"image","input":"photo.jpg","options":{}}' | \
  ittybit jobs create \
  --body -
```

## See also

- [API `POST /jobs`](/api/create-job) — create jobs via HTTP
- [API `GET /jobs`](/api/list-jobs) — list jobs via HTTP
- [`video`](/cli/video), [`audio`](/cli/audio), [`image`](/cli/image), [`adaptive`](/cli/adaptive) — process files locally instead