---
title: "Get an objective task by ID"
method: GET
path: "/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tasks/{id}"
tags: ["ObjectiveService", "Objectives"]
---

# Get an objective task by ID

`GET /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tasks/{id}`

Retrieves a task by ID from an objective

## Path parameters

- `workspaceId` string, required
- `objectiveId` string, required
- `id` string, required

## Response `200`

OK

- ObjectiveTask — ObjectiveTask represents a task within an objective, typically created and managed by an AI agent to track progress toward completing the objective.
  - `metadata` BareMetadata, required — 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` string
    - `name` string — 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).
  - `data` ObjectiveTaskData, required
    - `number` integer, required — The sequential number of this task within the objective (auto-assigned, 1-based)
    - `task` string, required — Description of the task to be completed
    - `completed` boolean, required — Whether the task has been completed
    - `completedAt` string, date-time — Timestamp when the task was marked as completed

## Other responses

- `default` — Default error response

---

[API](https://skmtc.dev/cadenya/apis/cadenya-api.md) · [All operations](https://skmtc.dev/cadenya/apis/cadenya-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cadenya/cadenya-api/revisions/ac1a7f084068/schema)