API Reference

Tasks

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Retrieve a task

client.Tasks.Get(ctx, taskID) (*TaskGetResponse, error)

GET/api/tasks/{taskId}

Retrieve a single task.

ParametersExpand Collapse

taskID string

ReturnsExpand Collapse

type TaskGetResponse struct{…}

Task Task

ID string

CompletedAt string

CreatedAt string

CreatedByUserID string

OrganizationID string

Status TaskStatus

One of the following:

const TaskStatusPending TaskStatus = "pending"

const TaskStatusRunning TaskStatus = "running"

const TaskStatusCompleted TaskStatus = "completed"

const TaskStatusError TaskStatus = "error"

const TaskStatusAborted TaskStatus = "aborted"

Title string

Totals TaskTotals

Aggregate credit spend, elapsed wall-clock, and number of turns across the task.

Credits int64

DurationMs int64

TurnCount int64

TriggeredBy TaskTriggeredBy

One of the following:

const TaskTriggeredByAPI TaskTriggeredBy = "api"

const TaskTriggeredByEmail TaskTriggeredBy = "email"

const TaskTriggeredBySchedule TaskTriggeredBy = "schedule"

const TaskTriggeredByUi TaskTriggeredBy = "ui"

URL string

Web URL of the task in the Handinger dashboard.

WorkerID string

Retrieve a task

Go

HTTP

TypeScript

Python

Go

Ruby

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/ramensoft/handinger-go"
  "github.com/ramensoft/handinger-go/option"
)

func main() {
  client := handinger.NewClient(
    option.WithAPIKey("My API Key"),
  )
  task, err := client.Tasks.Get(context.TODO(), "tsk_01HZY31W2SZJ8MJ2FQTR3M1K9D")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", task.Task)
}

200 example

{
  "task": {
    "id": "tsk_2Z-YWz3hFq6VlW",
    "completedAt": "2026-05-11T09:14:48.000Z",
    "createdAt": "2026-05-11T09:14:22.000Z",
    "createdByUserId": "usr_7yh-91XzM2nQ4",
    "organizationId": "org_8s1Df9aLp-1z",
    "status": "completed",
    "title": "Weather report for Barcelona",
    "totals": {
      "credits": 42,
      "durationMs": 25812,
      "turnCount": 1
    },
    "triggeredBy": "api",
    "url": "https://v3.handinger.com/worker/wrk_vk81XUHKHG-qr4/task/tsk_2Z-YWz3hFq6VlW",
    "workerId": "wrk_vk81XUHKHG-qr4"
  }
}

Returns Examples

200 example

{
  "task": {
    "id": "tsk_2Z-YWz3hFq6VlW",
    "completedAt": "2026-05-11T09:14:48.000Z",
    "createdAt": "2026-05-11T09:14:22.000Z",
    "createdByUserId": "usr_7yh-91XzM2nQ4",
    "organizationId": "org_8s1Df9aLp-1z",
    "status": "completed",
    "title": "Weather report for Barcelona",
    "totals": {
      "credits": 42,
      "durationMs": 25812,
      "turnCount": 1
    },
    "triggeredBy": "api",
    "url": "https://v3.handinger.com/worker/wrk_vk81XUHKHG-qr4/task/tsk_2Z-YWz3hFq6VlW",
    "workerId": "wrk_vk81XUHKHG-qr4"
  }
}