Skip to main content

API Reference

TEE API

Complete reference for the Task Execution Engine HTTP API — devices, actions, tasks, and the Personal Operator.

auth-header.ts
1// All /api/tee/* endpoints require:
2// Header: x-user-id:
3// Optional: x-device-id:

Devices

Register and manage devices in the TEE.

POSTAuth
/api/tee/devices/register

Register a new device with type, name, and capabilities

GETAuth
/api/tee/devices

List all devices belonging to the authenticated user

POSTAuth
/api/tee/devices/:deviceId/presence

Update device presence status (online/offline/idle/sleeping)

PUTAuth
/api/tee/devices/:deviceId/permissions

Update the device permission profile

PUTAuth
/api/tee/devices/:deviceId/capabilities

Update device capability flags

Actions

Submit and query single-step action executions.

POSTAuth
/api/tee/actions

Submit a single action. Returns ActionResult immediately or after execution.

GETAuth
/api/tee/actions/:actionId

Fetch the result of a previously submitted action.

Tasks

Multi-step task plans with dependencies.

POSTAuth
/api/tee/tasks

Submit a task plan. Steps execute respecting dependsOn graph.

GETAuth
/api/tee/tasks/:taskId

Fetch task status, steps, and all action results.

Personal Operator

High-level API for executing user intents.

POSTAuth
/api/operator/executeOperator

Execute a structured task plan on behalf of a user intent.

GETAuth
/api/operator/summaryOperator

Human-readable summary of actions taken in the last 24 hours.