revoke_app_password · Documentation Subagent

Retire un mot de passe d’application d’une boîte : l’appareil qui s’en sert perd aussitôt l’agenda, les contacts ou la lecture.

En bref

Propriété	Valeur
Titre	Retirer un mot de passe d’application
Outil MCP	`revoke_app_password`, sur `https://api.subagent.fr/mcp`
Appelé par	l’assistant et la vue
Appel HTTP	`POST https://api.subagent.fr/v1/revoke_app_password`
Accès	permission `approve`
État de l’espace	vérifié ou non
Effet	écriture, irréversible : `confirm` doit valoir `true`
Vue dans l’assistant	non

Ce que fait l’outil

Le serveur décrit l’outil ainsi à l’agent qui se branche :

Retire un mot de passe d’application d’une boîte : l’appareil qui s’en sert perd aussitôt l’agenda, les contacts ou la lecture. Ce que la boîte contient reste. Sans retour : passer confirm = true. C’est un geste humain : il demande la permission approve.

Paramètres

revoke_app_password accepte ces paramètres. Un paramètre inconnu est refusé avec le code invalid_argument.

Paramètre	Type	Obligatoire	Description
`inbox_id`	identifiant `inb_…`	oui	La boîte (inb_…, voir `list_inboxes`).
`app_password_id`	texte	oui	Le mot de passe à retirer (voir `list_app_passwords`).
`confirm`	booléen	oui	Doit valoir `true` : le retrait est sans retour.

Résultat

L’outil rend un texte lisible en français et un objet structuré (structuredContent). En HTTP, la réponse est cet objet.

Champ	Type	Contenu
`already_revoked`	booléen	`true` : il n’existait déjà plus, rien n’a changé.
`app_password_id`	texte	Le mot de passe retiré.
`inbox_id`	texte	La boîte (inb_…).
`revoked`	booléen	`true` : le mot de passe ne sert plus.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/revoke_app_password \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inbox_id": "inb_3f9c2a7e5b1d4c8e9a0f6b2d7c4e1a95",
  "app_password_id": "b4kq2",
  "confirm": true
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "revoke_app_password",
    "arguments": {
      "inbox_id": "inb_3f9c2a7e5b1d4c8e9a0f6b2d7c4e1a95",
      "app_password_id": "b4kq2",
      "confirm": true
    }
  }
}

Refus possibles

Code	HTTP	Ce qui s’est passé	Que faire
`not_found`	404	L’objet n’existe pas pour cette clé.	Vérifier l’identifiant : il vient de `list_inboxes`, `list_threads`, `get_thread` ou `list_drafts`.
`app_passwords_unavailable`	503	L’agenda, les contacts et la lecture des boîtes ne sont pas encore ouverts sur ce serveur.	Prévenir un administrateur de Subagent.
`inbox_not_managed`	409	Subagent ne garde pas le mot de passe de cette boîte : elle n’a pas de mot de passe d’application.	Prévenir un administrateur de Subagent.
`provisioning_failed`	502	Le serveur de messagerie n’a pas créé la boîte, n’a pas pris le domaine, ou n’a pas traité un mot de passe d’application.	Réessayer dans un instant. Rien n’est perdu.

S’y ajoutent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`revoke_app_password`