---
title: "GET jobs details"
method: GET
path: "/api/v1/jobs/{id}/details"
---

# GET jobs details

`GET /api/v1/jobs/{id}/details`

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `arguments_schema` object[], nullable — The schema for the arguments to parametrize this job. Each field is exposed in the script as `$ARGS_<UPPER_NAME>`. Example: `[{"fields": [{"name": "min_quality", "type": "integer"}, {"name": "adapter", "type": "string"}]}]`. The input sample is not a parameter; it is passed separately at run time
    - `description` string, nullable
    - `fa_icon` string, nullable
    - `fields` object[]
      - `choices` union[], nullable
        - union
          - string
          - integer
          - number
          - boolean
      - `default` unknown
      - `description` string, nullable
      - `env_name` string
      - `fa_icon` string, nullable
      - `help_text` string, nullable
      - `name` string, required
      - `pattern` string, nullable
      - `required` boolean
      - `type` union, required
        - 'string' | 'regex' | 'integer' | 'number' | 'boolean' | 'enum' | 'sample_id' | 'genome_id' | 'classified_sample_id' | 'assembly_id' | 'ref_assembly_by_tax_id' | 'genome_tax_id'
        - string[]
    - `title` string, nullable
  - `assets` object[], nullable — An optional list of assets associated with this job
    - `__DOLLAR_REF__` string, uri
  - `autorun_on_org_sample_upload` boolean, required — Whether this job runs automatically on every newly uploaded sample in the user's organization.
  - `cpu` number, nullable — The number of CPU cores used for this job, set only for shell script jobs
  - `dependencies` object[], nullable — Optional job dependencies for this job. If provided, will be triggered automatically when this job is run
    - `job` object, required — Parent job to use as a dependency
      - `__DOLLAR_REF__` string, uri
    - `output_dir` string, required — Directory into which to download the parent run results (must be relative, will be appended to /out directory)
  - `description` string, nullable — The human-readable description of the job. Supports markdown
  - `image_uri` string, required — Fully qualified OCI image URI used to run the job.
  - `inject_bearer_token` boolean, required — Whether the user's One Codex bearer token is injected into the analysis job as $ONE_CODEX_BEARER_TOKEN.
  - `job_type` 'shell_script' | 'nextflow', required — Whether this is a shell script or a Nextflow job.
  - `ram_gb` number, nullable — The amount of RAM used for this job in GB, set only for shell script jobs
  - `repository` object, nullable — The git repository that this job runs against
    - `tag` string, nullable — The git tag to use for this repository
    - `url` string, required — The URL of the git repository
  - `script` string, required — The script that is executed when the job runs.
  - `storage_gb` number, nullable — The amount of storage used for this job in GB, set only for shell script jobs

---

[API](https://skmtc.net/onecodex/apis/one-codex-api-v1.md) · [All operations](https://skmtc.net/onecodex/apis/one-codex-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onecodex/one-codex-api-v1/versions/fe9d9bfc8a6a/schema)