Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

revoke_app_password

View as .md

Remove an app password.

Removes an app password from an inbox: the device using it immediately loses the calendar, the contacts or the reading. What the inbox holds stays. No going back: pass confirm = true. This is a human gesture: it needs the approve permission.

Access

  • Key: an Escouade Mail key with approve.
  • Space: any space, verified or not.
  • Changes nothing: no, it acts.
  • Safe to replay: yes.

Parameters

ParameterTypeRequiredDescription
inbox_idstringyesThe inbox (inb_…, see list_inboxes).
app_password_idstringyesThe password to remove (see list_app_passwords).
confirmbooleanyesMust be true: removal cannot be undone.

Call it

Terminal
curl -s https://api.subagent.fr/v1/revoke_app_password \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"inbox_id": "…", "app_password_id": "…", "confirm": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/revoke_app_password.