---
title: creative jobs
description: Check generation job status, artifacts and history, and cancel queued jobs.
canonical_url: https://orchestor.io/docs/en/cli/creative/jobs
markdown_url: https://orchestor.io/docs/en/cli/creative/jobs.md
contentType: reference
---

# creative jobs

`orc creative jobs` works with the jobs that `image generate`, `video generate`, `tts generate` and `voice change` create. `jobs status` returns the state, `jobs result` the artifacts, and `jobs events` the state history.

A job ends as `COMPLETED`, `FAILED` or `CANCELED`. Only queued jobs can be canceled. See [Polling](https://orchestor.io/docs/creative/concepts/polling.md) for status intervals.

## Usage

```bash title="terminal"
orc creative jobs status <id> --json
```

*Check a job's status.*

```bash title="terminal"
orc creative jobs result <id> --json
```

*Get a completed job's artifacts.*

## Subcommands

### `list`

ジョブを一覧表示

```bash title="terminal"
orc creative jobs list [options]
```

#### Unique options

##### `--type`

取得する生成ジョブの種類。省略するとすべての種類を取得します。

Type: `string`. Optional.

```bash title="terminal"
orc creative jobs list --type <value>
```

##### `--types`

複数の種類をまとめて取得する場合に、types=image-router&types=video-router のように繰り返して指定します。type と同時には指定できません。; csv

Type: `string`. Optional.

```bash title="terminal"
orc creative jobs list --types <value>
```

##### `--status`

取得するジョブの処理状態。; enum: queued|processing|completed|failed|canceled

Type: `string`. Optional.

```bash title="terminal"
orc creative jobs list --status <value>
```

##### `--starting-after`

前のページの next_cursor。省略すると新しいジョブから取得します。

Type: `string`. Optional.

```bash title="terminal"
orc creative jobs list --starting-after <value>
```

### `get`

ジョブを取得

```bash title="terminal"
orc creative jobs get <id> [options]
```

### `status`

ジョブの状態を取得

```bash title="terminal"
orc creative jobs status <id> [options]
```

### `result`

ジョブの結果を取得

```bash title="terminal"
orc creative jobs result <id> [options]
```

### `events`

ジョブのイベントを一覧表示

```bash title="terminal"
orc creative jobs events <id> [options]
```

### `cancel`

ジョブをキャンセル

```bash title="terminal"
orc creative jobs cancel <id> [options]
```

## Examples

### List the Workspace's failed jobs.

```bash title="terminal"
orc creative jobs list --status failed --json
```

*List the Workspace's failed jobs.*

### Show the state history.

```bash title="terminal"
orc creative jobs events <id> --json
```

*Show the state history.*

### Cancel a queued job.

```bash title="terminal"
orc creative jobs cancel <id>
```

*Cancel a queued job.*

## Permissions

Requires CLI authentication (`orc auth login` or `ORCHESTOR_API_KEY`) and access to the target Workspace. Canceling a job requires write access.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc creative jobs`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)
