---
title: "Create a job from a given workflow"
method: POST
path: "/v0/workflows/{workflow_id}/jobs"
tags: ["Jobs"]
---

# Create a job from a given workflow

`POST /v0/workflows/{workflow_id}/jobs`

Create a job from a given workflow

## Path parameters

- `workflow_id` string, required

## Query parameters

- `project_id` string, required

## Response `200`

OK

- DexterPostWorkflowRunTransformerResponse
  - `created_by` string — Unique identifier of the user who created the job
  - `status` string — Current status of the job
  - `time_taken` string — Actual duration the job took to complete
  - `id` string — Unique identifier for the job
  - `tasks` DexterPostWorkflowTaskGet[] — List of tasks in this job
    - `id` string — Uniquely identifies each task in the workflow execution
    - `info_logs` integer[] — Debugging and execution information in raw bytes
    - `created_at` string — Timestamp when the task was initialized
    - `updated_at` string — Timestamp of the most recent task modification
    - `finished_at` string — Timestamp when task processing ended
    - `estimated_time_duration` integer — Predicted seconds until task completes
    - `time_taken` string — Actual duration from start to finish
    - `status` string — Current execution status of the task
    - `state_msg` string — Additional context about the current state
    - `inputs` integer[] — Raw JSON data supplied to the task
    - `result` integer[] — Raw JSON output produced by the task
    - `depends_on` string[] — Lists task names that must finish before this task begins
    - `name` string — Descriptive label for the task
    - `progress` number — Completion percentage from 0 to 100
    - `disclaimer` string[] — Warnings or notices about task execution
    - `recv_time` string — Timestamp when the system received the task request
    - `send_time` string — Timestamp when the task was sent for execution
    - `block_inf_start_time` string — Marks when inference processing began
    - `block_inf_end_time` string — Marks when inference processing completed
    - `block_info` object — Describes the block used in the task
      - `id` string — Unique identifier for this block
      - `name` string — Human-friendly block identifier
      - `version` string — Semantic versioning string of the block
    - `err_msg` string — Error text returned by the model during execution
    - `failure_type` string — Categorizes the specific error that occurred
  - `val_errors` DexterValError[] — Validation errors encountered
    - `from` string — Source component of the validation error
    - `to` string — Target component of the validation error
    - `err` string — Error message
    - `reason` string — Additional context about why the error occurred
    - `component_name` string — Specific component that generated the error
  - `spec` integer[] — Raw specification data for the job
  - `cost` integer — Token cost of the job
  - `workflow_id` string — Unique identifier of the workflow this job belongs to
  - `updated_at` string — Timestamp when the job was last updated
  - `finished_at` string — Timestamp when the job was completed
  - `exec_created_at` string — Timestamp when the job execution was created
  - `exec_updated_at` string — Timestamp when the job execution was last updated
  - `created_at` string — Timestamp when the job was created
  - `estimated_duration` integer — Expected time in seconds to complete the job
  - `progress` string — Completion percentage of the job

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)