---
title: "POST /api/projects/{pid}/spiders/{sid}/jobs"
method: POST
path: "/api/projects/{pid}/spiders/{sid}/jobs"
tags: ["api"]
---

# POST /api/projects/{pid}/spiders/{sid}/jobs

`POST /api/projects/{pid}/spiders/{sid}/jobs`

## Query parameters

- `sync` boolean

## Request body

- SpiderJobCreate
  - `jid` integer — A unique integer value identifying this job.
  - `name` string — Unique job name.
  - `args` SpiderJobArg[] — Job arguments.
    - `name` string, required — Argument name.
    - `value` string, required — Argument value.
  - `env_vars` SpiderJobCreateEnvVar[] — Job env variables.
    - `evid` integer — Env var id.
    - `name` string, required — Env var name.
    - `value` string, required — Env var value.
    - `masked` boolean — Env var masked.
  - `tags` SpiderJobTag[] — Job tags.
    - `name` string, required — Tag name.
  - `job_status` string — Current job status.
  - `cronjob` integer, nullable — Related cron job.
  - `data_expiry_days` integer — Days before data expires.
  - `data_status` string, required — Data status.
  - `resource_tier` 'TINY' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'XLARGE' | 'HUGE' | 'XHUGE' — Resource tier for K8s pod allocation.

## Response `201`

Created

- SpiderJobCreate
  - `jid` integer — A unique integer value identifying this job.
  - `name` string — Unique job name.
  - `args` SpiderJobArg[] — Job arguments.
    - `name` string, required — Argument name.
    - `value` string, required — Argument value.
  - `env_vars` SpiderJobCreateEnvVar[] — Job env variables.
    - `evid` integer — Env var id.
    - `name` string, required — Env var name.
    - `value` string, required — Env var value.
    - `masked` boolean — Env var masked.
  - `tags` SpiderJobTag[] — Job tags.
    - `name` string, required — Tag name.
  - `job_status` string — Current job status.
  - `cronjob` integer, nullable — Related cron job.
  - `data_expiry_days` integer — Days before data expires.
  - `data_status` string, required — Data status.
  - `resource_tier` 'TINY' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'XLARGE' | 'HUGE' | 'XHUGE' — Resource tier for K8s pod allocation.

---

[API](https://skmtc.net/bitmakerla/apis/estela-api-v1-0-documentation.md) · [All operations](https://skmtc.net/bitmakerla/apis/estela-api-v1-0-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitmakerla/estela-api-v1-0-documentation/versions/ec53774a2b78/schema)