---
title: "Get External Edit Tool Task"
method: GET
path: "/edit/tasks/{task_id}"
tags: ["edit"]
---

# Get External Edit Tool Task

`GET /edit/tasks/{task_id}`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/edit/tasks/{task_id}`
- Auth: none declared. Required headers: `X-RD-Token`

Status of an edit job started with POST /edit/tools/{tool_id}/tasks.

## Path parameters

- `task_id` string, required

## Headers

- `X-RD-Token` string, required

## Response `200`

Successful Response

- ExternalEditToolTaskRead: Status of an edit job started with POST /edit/tools/{tool_id}/tasks. When the job succeeds, result holds the hosted image in output_urls and base64_images is empty.
  - `status` 'pending' | 'running' | 'succeeded' | 'failed', required
  - `task_id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `result` ExternalEditToolRunOutput: Additive /v1 response: canonical fields plus deprecated v1 camelCase.
    - `tool_id` string, required
    - `inference_id` string
    - `balance_cost` number
    - `credit_cost` integer
    - `charged` boolean
    - `remaining_credits` integer
    - `remaining_balance` number
    - `base64_images` string[]
    - `output_urls` string[]
    - `output_width` integer
    - `output_height` integer
    - `scheduled_region_summary` object
    - `scheduled_region_job_id` integer
    - `request_id` string
    - `toolId` string, required
    - `outputImageBase64` string
    - `outputImageUrl` string
    - `inferenceId` string
    - `balanceCost` number
    - `creditCost` integer
    - `scheduledRegionSummary` object
    - `scheduledRegionJobId` integer
  - `error` V2AsyncTaskError
    - `status_code` integer, required
    - `code` string, required
    - `message` string, required
    - `request_id` string, required
    - `details` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api.md) · [All operations](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/revisions/9c76250e8e2d?raw)