Endpoints mission control
Reference API pour la gestion des taches, les workflows d'approbation, le streaming d'activite et les donnees du tableau de bord.
Taches
Lister les taches
GET /api/mission-control/tasks
Retourne toutes les taches de l'utilisateur authentifie, ordonnees par date de creation (plus recentes d'abord).
Parametres de requete :
| Parametre | Type | Description |
|---|---|---|
status | string | Filtrer par statut : pending, running, review, done, failed, cancelled |
desktopId | string | Filtrer par bureau cible |
Reponse :
[
{
"id": "task_abc123",
"type": "prompt",
"content": "Installer PostgreSQL et creer une base de donnees",
"status": "running",
"desktopId": "clx...",
"requiresApproval": true,
"createdAt": "2026-03-15T10:00:00Z",
"startedAt": "2026-03-15T10:01:00Z",
"completedAt": null
}
]
Creer une tache
POST /api/mission-control/tasks
Body :
| Champ | Type | Requis | Description |
|---|---|---|---|
type | "prompt" ou "command" | Oui | Mode d'execution de la tache |
content | string | Oui | Texte du prompt ou commande shell |
desktopId | string | Oui | ID du bureau cible |
requiresApproval | boolean | Non | Si true, la tache se met en pause a review (defaut : false, sauf si le parametre global est actif) |
Reponse : 201 avec la tache creee.
Executer une tache
POST /api/mission-control/tasks/:id/run
Demarre une tache en attente. La tache doit etre en statut pending.
- Les taches prompt sont envoyees a l'agent IA du bureau via l'endpoint chat
- Les taches commande sont executees directement via SSH
Reponse : 200 avec la tache mise a jour (status : running).
Erreur : 409 si la tache n'est pas en statut pending.
Revoir une tache
POST /api/mission-control/tasks/:id/review
Approuver ou rejeter une tache en statut review.
Body :
| Champ | Type | Requis | Description |
|---|---|---|---|
decision | "approve" ou "reject" | Oui | Votre decision de revue |
feedback | string | Non | Explication (utile lors du rejet) |
Reponse : 200 avec la tache mise a jour.
- Les taches approuvees passent a
done - Les taches rejetees passent a
failed
Erreur : 409 si la tache n'est pas en statut review.
Approbations
Lister les approbations
GET /api/mission-control/approvals
Retourne tous les enregistrements d'approbation en attente.
Reponse :
[
{
"id": "approval_xyz",
"taskId": "task_abc123",
"status": "pending",
"createdAt": "2026-03-15T10:05:00Z",
"task": {
"id": "task_abc123",
"type": "prompt",
"content": "Installer PostgreSQL...",
"desktopId": "clx..."
}
}
]
Resoudre une approbation
POST /api/mission-control/approvals/:id/resolve
Body :
| Champ | Type | Requis | Description |
|---|---|---|---|
decision | "approve" ou "reject" | Oui | Votre decision |
feedback | string | Non | Feedback optionnel |
Reponse : 200 avec l'approbation resolue. La tache associee est mise a jour en consequence.
Flux d'activite
GET /api/mission-control/activity/stream
Endpoint SSE qui pousse des evenements pour les taches, bureaux et approbations en temps reel. Voir Endpoints streaming pour les details de consommation et exemples de code.
Vue d'ensemble du tableau de bord
GET /api/mission-control/overview
Retourne les donnees agregees pour le tableau de bord mission control.
Reponse :
{
"tasks": {
"pending": 3,
"running": 1,
"review": 2,
"done": 45,
"failed": 3,
"cancelled": 1
},
"activeDesktops": 4,
"resources": {
"cpu": 34.2,
"memory": { "used": 8192, "total": 16384, "percent": 50.0 }
}
}
Codes d'erreur
| Statut | Signification |
|---|---|
400 | Body ou parametres de requete invalides |
401 | Non authentifie |
404 | Tache ou approbation non trouvee |
409 | Conflit de statut -- la tache n'est pas dans le statut requis pour cette operation |