Tack
Reference

HTTP API

REST API reference for the Tack daemon.

The daemon exposes a REST API on the configured listen address (default 127.0.0.1:9800).

Objectives

MethodPathDescription
POST/objectivesCreate a new objective
GET/objectivesList all objectives
GET/objectives/:idGet objective by ID
GET/objectives/:id/planGet plan for objective
POST/objectives/:id/executeTrigger execution

POST /objectives

{
  "description": "Add pagination to list endpoints",
  "blueprint": "Feature Implementation",
  "simple": false
}

Plans

MethodPathDescription
POST/plansCreate plan from planner output
GET/plansList all plans
GET/plans/:idGet plan with streams
POST/plans/:id/approveApprove plan
POST/plans/:id/rejectReject plan
GET/plans/:id/streamsList streams for plan

Streams

MethodPathDescription
GET/streams/:idGet stream by ID
GET/streams/:id/diffGet merge diff for stream

Executions

MethodPathDescription
GET/executionsList all executions
GET/executions/:idGet execution by ID
POST/executions/:id/approveApprove human gate
POST/executions/:id/retryRetry failed stream

POST /executions/:id/retry

{
  "guidance": "Try using the existing helper function instead"
}

Agents

MethodPathDescription
GET/agentsList agent sessions
GET/agents/:idGet agent session
POST/agents/:id/killKill running agent

Mail

MethodPathDescription
POST/mailSend a message
GET/mailList messages (filterable)
GET/mail/:agent/unreadGet unread messages
POST/mail/:id/readMark message read
POST/mail/:agent/read-allMark all read

Merge Queue

MethodPathDescription
GET/merge-queueList merge entries
GET/merge-queue/:idGet merge entry
POST/merge-queue/:id/retryRetry failed merge

System

MethodPathDescription
GET/healthHealth check
GET/statusDaemon status with uptime
GET/blueprintsList available blueprints
GET/blueprints/:nameGet blueprint by name
GET/eventsSSE event stream

Configuration Reference

Full reference for .tack/config.yaml options.

On this page

ObjectivesPOST /objectivesPlansStreamsExecutionsPOST /executions/:id/retryAgentsMailMerge QueueSystem