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

# cowboy job

> Submit off-chain compute jobs and read their results

`cowboy job` submits a job from your wallet and reads back its status and results. Actors usually submit jobs from their own code; see [Submit jobs](https://docs.cowboy.inc/developers/submitting-jobs.md).

```bash theme={"system"}
cowboy job submit --job-spec job.json --dry-run
cowboy job status --job-id <job id>
```

```text theme={"system"}
cowboy job [OPTIONS] <COMMAND>
```

| Command | Description |
| - | - |
| [`get`](#cowboy-job-get) | Get job specification |
| [`status`](#cowboy-job-status) | Get job status |
| [`runners`](#cowboy-job-runners) | Get assigned runners for a job |
| [`results`](#cowboy-job-results) | Get all results for a job |
| [`verified`](#cowboy-job-verified) | Get verified result for a job |
| [`submit`](#cowboy-job-submit) | Submit a no-callback wallet job, or validate it without broadcasting |

## cowboy job get

Get job specification

```text theme={"system"}
cowboy job get [OPTIONS] --job-id <JOB_ID>
```

| Option | Description |
| - | - |
| `-j, --job-id <JOB_ID>` | Job ID (hex format) |
| `--json` | Emit one versioned JSON result |

## cowboy job status

Get job status

```text theme={"system"}
cowboy job status [OPTIONS] --job-id <JOB_ID>
```

| Option | Description |
| - | - |
| `-j, --job-id <JOB_ID>` | Job ID (hex format) |
| `--json` | Emit one versioned JSON result |

## cowboy job runners

Get assigned runners for a job

```text theme={"system"}
cowboy job runners [OPTIONS] --job-id <JOB_ID>
```

| Option | Description |
| - | - |
| `-j, --job-id <JOB_ID>` | Job ID (hex format) |
| `--json` | Emit one versioned JSON result |

## cowboy job results

Get all results for a job

```text theme={"system"}
cowboy job results [OPTIONS] --job-id <JOB_ID>
```

| Option | Description |
| - | - |
| `-j, --job-id <JOB_ID>` | Job ID (hex format) |
| `--json` | Emit one versioned JSON result |

## cowboy job verified

Get verified result for a job

```text theme={"system"}
cowboy job verified [OPTIONS] --job-id <JOB_ID>
```

| Option | Description |
| - | - |
| `-j, --job-id <JOB_ID>` | Job ID (hex format) |
| `--json` | Emit one versioned JSON result |

## cowboy job submit

Submit a no-callback wallet job, or validate it without broadcasting

```text theme={"system"}
cowboy job submit [OPTIONS] <--job-spec <JOB_SPEC>|--http <METHOD> <URL>|--llm <PROMPT>>
```

| Option | Description |
| - | - |
| `-j, --job-spec <JOB_SPEC>` | Job request/specification file (JSON); chain-derived fields may be omitted |
| `--http <METHOD> <URL>` | Build an HTTP job from METHOD and URL |
| `--llm <PROMPT>` | Build an LLM job from a prompt; select its model with `--model` |
| `--model <MODEL>` | Model name for `--llm` (hashed by the shared protocol normalizer) |
| `--max-price <MAX_PRICE>` | Nonzero job price limit in protocol units; required for `--http` or `--llm` |
| `--tip <TIP>` | Optional job tip in protocol units (short requests only; default zero) |
| `--dry-run` | Check canonical encoding and shared JobSpec rules; do not sign, create volumes or submit |
| `--nonce <NONCE>` | Transaction nonce (0 = auto). Default: `0`. |
| `--no-wait` | Return once the node admits the transaction, without waiting for it to commit (the job id is then not yet known) |
| `--json` | Emit one versioned JSON result |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.