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

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

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

## Request body

- SpiderCronJobCreate
  - `cjid` integer — A unique integer value identifying this cron job.
  - `name` string — Unique cron job name.
  - `cargs` SpiderJobArg[] — Cron job arguments.
    - `name` string, required — Argument name.
    - `value` string, required — Argument value.
  - `cenv_vars` SpiderJobEnvVar[] — Cron job env variables.
    - `evid` integer, nullable — A unique integer value identifying this job env variable.
    - `name` string, required — Env variable name.
    - `value` string, required — Env variable value.
    - `masked` boolean — Whether the env variable value is masked.
  - `ctags` SpiderJobTag[] — Cron job tags.
    - `name` string, required — Tag name.
  - `schedule` string — Cron job schedule definition.
  - `unique_collection` boolean — True if this cron job stores its items in a unique collection.
  - `data_expiry_days` integer, required — Days before data expires.
  - `data_status` 'PERSISTENT' | 'PENDING' | 'DELETED', required — Data status.
  - `resource_tier` 'TINY' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'XLARGE' | 'HUGE' | 'XHUGE' — Resource tier for jobs created by this cron job.

## Response `201`

Created

- SpiderCronJobCreate
  - `cjid` integer — A unique integer value identifying this cron job.
  - `name` string — Unique cron job name.
  - `cargs` SpiderJobArg[] — Cron job arguments.
    - `name` string, required — Argument name.
    - `value` string, required — Argument value.
  - `cenv_vars` SpiderJobEnvVar[] — Cron job env variables.
    - `evid` integer, nullable — A unique integer value identifying this job env variable.
    - `name` string, required — Env variable name.
    - `value` string, required — Env variable value.
    - `masked` boolean — Whether the env variable value is masked.
  - `ctags` SpiderJobTag[] — Cron job tags.
    - `name` string, required — Tag name.
  - `schedule` string — Cron job schedule definition.
  - `unique_collection` boolean — True if this cron job stores its items in a unique collection.
  - `data_expiry_days` integer, required — Days before data expires.
  - `data_status` 'PERSISTENT' | 'PENDING' | 'DELETED', required — Data status.
  - `resource_tier` 'TINY' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'XLARGE' | 'HUGE' | 'XHUGE' — Resource tier for jobs created by this cron job.

---

[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)