image:task

Poll the status of an async image processing task.

Type: Synchronous (status check)

Usage

Bash

simplified image:task --id <task-id>

Options

Flag	Type	Required	Description
--id	string	✅	Task ID returned by an async image command

Example

Bash

simplified image:task --id "abc123"

Response

JSON

{
  "task_id": "abc123",
  "status": "completed",
  "url": "https://cdn.simplified.com/result.png"
}

Status Values

Status	Meaning
pending	Task is queued or processing
completed / success	Result is ready — url field contains the output
failed	Processing failed

Async Polling Pattern

Bash

TASK_ID=$(simplified image:upscale --url "https://example.com/photo.jpg" --scale 4 | jq -r '.task_id')

# Poll until done
while true; do
  RESULT=$(simplified image:task --id "$TASK_ID")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "success" ]; then
    echo "$RESULT" | jq -r '.url'
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Task failed" >&2
    break
  fi
  sleep 3
done

Tip: Use --wait on most image commands to avoid manual polling.