---
title: "Submit Run"
method: POST
path: "/v4/runs"
tags: ["Runs"]
---

# Submit Run

`POST /v4/runs`

Submits a new run request

## Request body

- PipelineCloudSchemasRunsRunCreate — Base model for schemas.
  - `run_id` string
  - `inputs` PipelineCloudSchemasRunsRunInput[], required
    - `type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `value` unknown
    - `file_name` string
    - `file_path` string
    - `file_url` string
  - `pipeline` string, required
  - `async_run` boolean
  - `wait_for_resources` boolean

## Response `200`

Successful Response

- ClusterRunResult — Base model for schemas.
  - `inputs` PipelineCloudSchemasRunsRunInput[]
    - `type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `value` unknown
    - `file_name` string
    - `file_path` string
    - `file_url` string
  - `outputs` PipelineCloudSchemasRunsRunOutput[]
    - `type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `value` unknown
    - `file` PipelineCloudSchemasRunsRunOutputFile — Base model for schemas.
      - `name` string, required
      - `path` string, required
      - `url` string
      - `size` integer, required
  - `error` ContainerRunError — Base model for schemas.
    - `type` 'input_error' | 'cuda_oom' | 'cuda_error' | 'oom' | 'pipeline_error' | 'startup_error' | 'pipeline_loading' | 'timeout' | 'unknown', required — An enumeration.
    - `message` string, required
    - `traceback` string
  - `id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `pipeline_id` string, required
  - `state` 'created' | 'routing' | 'queued' | 'running' | 'completed' | 'failed' | 'no_resources_available' | 'node_preempted' | 'unknown', required — An enumeration.
  - `queue_position` integer

## Other responses

- `401` — Not authenticated
- `402` — Account deactivated due to billing. Please add a payment method.
- `403` — Permission denied (for example, accessing a pipeline that is owned by another user)
- `404` — Resource not found
- `422` — Validation Error
- `503` — This pipeline is currently starting up. This is normal behaviour for pipelines that are new or have not been run in a while. Please wait a few minutes before next run.

---

[API](https://skmtc.net/mystic/apis/mystic-api.md) · [All operations](https://skmtc.net/mystic/apis/mystic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mystic/mystic-api/revisions/60e569344994/schema)