Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

HTTP API

The API listens on port 11000 by default and is called without TLS inside the task network. Client calls send the configured HTTP Basic Auth values; however, the current Flask API does not enforce authentication itself. In production, keep it behind an appropriately protected internal network boundary.

MethodPathPurpose
GET/v0/statusReturns ok once all active tasks are TASK_RUNNING
GET/v0/task/<id>/jobReturns the job name, task index, and current cluster_def
PUT/v0/task/<id>/port/<port>Reports a task port; the port must be 1–65535
PUT/v0/task/<id>Marks a task as initialized
GET/v0/download/<filename>Serves a file from the working directory

Unknown task IDs return 404 for mutation requests; invalid ports return 400. The download route rejects paths containing ...