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

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

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

## Request body

- SpiderJobUpdate
  - `jid` integer — A unique integer value identifying this job.
  - `status` 'IN_QUEUE' | 'WAITING' | 'RUNNING' | 'STOPPED' | 'COMPLETED' | 'ERROR' — Job status.
  - `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.
  - `data_status` 'PERSISTENT' | 'PENDING' | 'DELETED' — Job data status.
  - `data_expiry_days` integer — Job data expiry days.
  - `proxy_usage_data` string — Proxy Usage data.
  - `error_reason` string, nullable — Error logs to persist in job_logs (Mongo) on failure.

## Response `200`

OK

- SpiderJobUpdate
  - `jid` integer — A unique integer value identifying this job.
  - `status` 'IN_QUEUE' | 'WAITING' | 'RUNNING' | 'STOPPED' | 'COMPLETED' | 'ERROR' — Job status.
  - `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.
  - `data_status` 'PERSISTENT' | 'PENDING' | 'DELETED' — Job data status.
  - `data_expiry_days` integer — Job data expiry days.
  - `proxy_usage_data` string — Proxy Usage data.
  - `error_reason` string, nullable — Error logs to persist in job_logs (Mongo) on failure.

---

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