---
title: "Create a job (task template)"
method: POST
path: "/jobs"
---

# Create a job (task template)

`POST /jobs`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/jobs`
- Auth: HTTP bearer

`prompt` may contain {{placeholder}} tokens filled by `inputs` at run time. `input_schema.required` (if set) is validated per run. `output_schema` declares the result shape.

## Request body

- object
  - `project_id` string, required
  - `name` string, required
  - `description` string
  - `prompt` string, required
  - `model` 'haiku' | 'sonnet' | 'opus'
  - `input_schema` object
  - `output_schema` object

## Response `201`

Created

---

[API](https://skmtc.dev/openhelm/apis/openhelm-public-api.md) · [All operations](https://skmtc.dev/openhelm/apis/openhelm-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openhelm/apis/openhelm-public-api/revisions/2af88dc2f6a7?raw)