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

# PUT /tasks/{id}

`PUT /tasks/{id}`

## 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}`
- 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/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Request body

- TaskTaskSwagger
  - `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
  - `tokenUsage` integer
  - `updatedAt` string
  - `userId` string

## Response `200`

Task 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`: Queued: data is TaskQueuedResponse for a database retry, or Task when retrying an already queued child batch

---

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