Skip to content
cadenya
Get started
API Reference
Objectives
Tasks

Get an objective task by ID

client.Objectives.Tasks.Get(ctx, objectiveID, id) (*ObjectiveTask, error)
GET/v1/objectives/{objectiveId}/tasks/{id}

Retrieves a task by ID from an objective

ParametersExpand Collapse
objectiveID string
id string
ReturnsExpand Collapse
type ObjectiveTask struct{…}

ObjectiveTask represents a task within an objective, typically created and managed by an AI agent to track progress toward completing the objective.

Completed bool

Whether the task has been completed

Number int64

The sequential number of this task within the objective (auto-assigned, 1-based)

formatint32
Task string

Description of the task to be completed

CompletedAt Timeoptional

Timestamp when the task was marked as completed

formatdate-time
Metadata BareMetadata

BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves.

ID stringoptional
Name stringoptional

Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks).

Get an objective task by ID

package main

import (
  "context"
  "fmt"

  "github.com/cadenya/cadenya-go"
  "github.com/cadenya/cadenya-go/option"
)

func main() {
  client := cadenya.NewClient(
    option.WithAPIKey("My API Key"),
  )
  objectiveTask, err := client.Objectives.Tasks.Get(
    context.TODO(),
    "objectiveId",
    "id",
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", objectiveTask.Data)
}

{
  "data": {
    "completed": true,
    "number": 0,
    "task": "task",
    "completedAt": "2019-12-27T18:11:19.117Z"
  },
  "metadata": {
    "id": "id",
    "name": "name"
  }
}
Returns Examples
{
  "data": {
    "completed": true,
    "number": 0,
    "task": "task",
    "completedAt": "2019-12-27T18:11:19.117Z"
  },
  "metadata": {
    "id": "id",
    "name": "name"
  }
}