Skip to content
cadenya
Get started
API Reference
Objectives
Tasks

List objective tasks

client.Objectives.Tasks.List(ctx, objectiveID, query) (*CursorPagination[ObjectiveTask], error)
GET/v1/objectives/{objectiveId}/tasks

Lists all tasks for an objective

ParametersExpand Collapse
objectiveID string
query ObjectiveTaskListParams
Cursor param.Field[string]optional

Pagination cursor from previous response

Limit param.Field[int64]optional

Maximum number of results to return

formatint32
SortOrder param.Field[string]optional

Sort order for results

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).

List objective tasks

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"),
  )
  page, err := client.Objectives.Tasks.List(
    context.TODO(),
    "objectiveId",
    cadenya.ObjectiveTaskListParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

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