---
title: "Query Task"
method: GET
path: "/v1/common_task/image_edit/task/query"
tags: ["Image Edit"]
---

# Query Task

`GET /v1/common_task/image_edit/task/query`

Query the status and result of a previously submitted image editing task.

## Query parameters

- `taskId` string, required
- `needCloudFrontUrl` boolean

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Response `200`

Task result retrieved successfully

- object
  - `code` string — Response code
  - `message` string — Response message
  - `result` object
    - `taskId` string — Unique task identifier
    - `status` 'init' | 'running' | 'success' | 'fail' — Task status. 'init' - task created, 'running' - processing, 'success' - completed successfully, 'fail' - failed
    - `errorMsg` string, nullable — Error message if task failed (status=fail)
    - `costCredit` number — Credits consumed for this task
    - `boardId` string, nullable — Associated board ID (if task was created from a board)
    - `images` object[], nullable — List of edited images (only available when status=success)
      - `status` 'init' | 'running' | 'success' | 'fail' — Sub-task status
      - `fileId` string — File record ID in the system
      - `filePath` string — URL path to the edited image
      - `width` integer — Image width in pixels
      - `height` integer — Image height in pixels
      - `errorMsg` string, nullable — Error message for this image (if editing failed)
      - `boardTaskId` string, nullable — Associated board task ID

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/revisions/83cd46ca7859/schema)