API Reference
TEE API
Complete reference for the Task Execution Engine HTTP API — devices, actions, tasks, and the Personal Operator.
| 1 | // All /api/tee/* endpoints require: |
| 2 | // Header: x-user-id: |
| 3 | // Optional: x-device-id: |
Devices
Register and manage devices in the TEE.
/api/tee/devices/registerRegister a new device with type, name, and capabilities
/api/tee/devicesList all devices belonging to the authenticated user
/api/tee/devices/:deviceId/presenceUpdate device presence status (online/offline/idle/sleeping)
/api/tee/devices/:deviceId/permissionsUpdate the device permission profile
/api/tee/devices/:deviceId/capabilitiesUpdate device capability flags
Actions
Submit and query single-step action executions.
/api/tee/actionsSubmit a single action. Returns ActionResult immediately or after execution.
/api/tee/actions/:actionIdFetch the result of a previously submitted action.
Tasks
Multi-step task plans with dependencies.
/api/tee/tasksSubmit a task plan. Steps execute respecting dependsOn graph.
/api/tee/tasks/:taskIdFetch task status, steps, and all action results.
Personal Operator
High-level API for executing user intents.
/api/operator/executeOperatorExecute a structured task plan on behalf of a user intent.
/api/operator/summaryOperatorHuman-readable summary of actions taken in the last 24 hours.