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

# PATCH /api/projects/{pid}/spiders/{sid}/jobs/{jid}

`PATCH /api/projects/{pid}/spiders/{sid}/jobs/{jid}`

## Request body

- SpiderJob — Project jobs.
  - `jid` integer — A unique integer value identifying this job.
  - `spider` string
  - `created` string, date-time — Job creation date.
  - `name` string — Unique job name.
  - `lifespan` number — The elapsed seconds the spider job was running.
  - `total_response_bytes` integer — The total bytes received in responses.
  - `item_count` integer — The number of items extracted in the job.
  - `request_count` integer — The number of requests made by the spider job.
  - `args` SpiderJobArg[] — Job arguments.
    - `name` string, required — Argument name.
    - `value` string, required — Argument value.
  - `env_vars` SpiderJobEnvVar[] — 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.
  - `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, nullable — Days before data is deleted.
  - `data_status` 'PERSISTENT' | 'PENDING' | 'DELETED' — Data status.
  - `database_insertion_progress` string
  - `storage_size` string
  - `resource_tier` 'TINY' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'XLARGE' | 'HUGE' | 'XHUGE' — Resource tier for K8s pod allocation.
  - `peak_memory` string

## Response `200`

OK

- SpiderJob — Project jobs.
  - `jid` integer — A unique integer value identifying this job.
  - `spider` string
  - `created` string, date-time — Job creation date.
  - `name` string — Unique job name.
  - `lifespan` number — The elapsed seconds the spider job was running.
  - `total_response_bytes` integer — The total bytes received in responses.
  - `item_count` integer — The number of items extracted in the job.
  - `request_count` integer — The number of requests made by the spider job.
  - `args` SpiderJobArg[] — Job arguments.
    - `name` string, required — Argument name.
    - `value` string, required — Argument value.
  - `env_vars` SpiderJobEnvVar[] — 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.
  - `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, nullable — Days before data is deleted.
  - `data_status` 'PERSISTENT' | 'PENDING' | 'DELETED' — Data status.
  - `database_insertion_progress` string
  - `storage_size` string
  - `resource_tier` 'TINY' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'XLARGE' | 'HUGE' | 'XHUGE' — Resource tier for K8s pod allocation.
  - `peak_memory` string

---

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