Skip to content
Get started

Tasks

List objective tasks
client.Objectives.Tasks.List(ctx, objectiveID, query) (*CursorPagination[ObjectiveTask], error)
GET/v1/objectives/{objectiveId}/tasks
Get an objective task by ID
client.Objectives.Tasks.Get(ctx, objectiveID, id) (*ObjectiveTask, error)
GET/v1/objectives/{objectiveId}/tasks/{id}
ModelsExpand 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).

type ObjectiveTaskData struct{…}
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