---
type: "Task"
title: "Task — the unit of governed work"
description: "The core work object an agent creates, prioritizes, completes, or reverses. Every write clears the Constitution and is recorded in the signed audit chain."
resource: "/openapi.json"
tags: ["work", "act"]
timestamp: "2026-06-25"
---

A Task is what MCP tools and the REST API operate on. Creating or mutating one is an *action* that the [Constitution](/knowledge/okf/constitution.md) gates and that closes with a signed [Outcome Receipt](/verify-receipt/).

# Schema
- `title` — string, the work to be done
- `priority` — one of: low | medium | high | critical
- `deadline` — date or null
- `assignee` — identity or null
- `tags` — string[] (used by the constitution's objective/forbidden tag rules)
- `done` — boolean (completion state)
- `source` — where the task came from (human | agent | import | connector)

# Citations
Actions: MCP at `/mcp`, REST at `/api/v1/agent/*`. Contract: [OpenAPI 3.1](/openapi.json). Proof of completion: [Outcome Receipt](/verify-receipt/).
