---
title: "PUT /tasks/{id}/status"
method: PUT
path: "/tasks/{id}/status"
tags: ["tasks"]
---

# PUT /tasks/{id}/status

`PUT /tasks/{id}/status`

## Request

- Base URL: `https://api.mrscraper.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mrscraper.com/tasks/{id}/status`
- Auth: one of:
  - API key in header `x-api-token`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api/docs/tasks/:id/status/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Request body

- TaskUpdateTaskStatusRequest
  - `result` string
  - `solution` string
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
  - `taskDetails` object

## Response `200`

Task status updated

- object
  - `data` TaskTask
    - `action` string
    - `browserType` 'CHROME' | 'FIREFOX' | 'SAFARI'
    - `callbackUrl` string
    - `createdAt` string
    - `deviceOs` 'WINDOWS' | 'MACOS' | 'LINUX'
    - `domain` string
    - `fingerprintId` integer
    - `id` integer
    - `jobId` integer
    - `proxy` string
    - `result` string
    - `retryCount` integer
    - `scrapeTime` number
    - `solution` string
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
    - `statusMessage` string
    - `taskDetails` object
    - `updatedAt` string
    - `userId` string
  - `message` string

## Other responses

- `201`: Task cloned from a locked period; originalTaskId identifies the preserved task
- `202`: Task status update queued for a database retry

---

[API](https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api.md) - [All operations](https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mrscraper/apis/scraper-service-gateway-api/revisions/8bc866001a0b?raw)