---
title: "Schedule a job"
method: POST
path: "/projects/{owner}/{name}/jobs"
tags: ["Jobs"]
---

# Schedule a job

`POST /projects/{owner}/{name}/jobs`

Create a new job.

## Path parameters

- `owner` string, required
- `name` string, required

## Headers

- `authorization` string
- `x-pollination-token` string

## Request body

- Job — Queenbee Job. A Job is an object to submit a list of arguments to execute a Queenbee recipe.
  - `type` string
  - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
  - `api_version` string
  - `source` string, required — The source url for downloading the recipe.
  - `arguments` array[] — Input arguments for this job.
    - union[]
      - union
        - JobArgument — Job argument is an argument input for arguments which are not files or folders.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Argument name. The name must match one of the input names from Job's DAG template.
          - `value` unknown, required
        - JobPathArgument — BaseModel with functionality to return the object as a yaml string.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Argument name. The name must match one of the input names from Job's template which can be a function or DAG.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
  - `name` string — An optional name for this job. This name will be used a the display name for the run.
  - `description` string — Run description.
  - `labels` object — Optional user data as a dictionary. User data is for user reference only and will not be used in the execution of the job.

## Response `201`

Successful Response

- CreatedContent — Content for created response.
  - `id` string, uuid, required — Id for the newly created resource.
  - `message` string — A human readable message

## Other responses

- `422` — Validation Error

---

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