list_drafts · Escouade Mail documentation

Drafts awaiting approval.

Lists the drafts waiting for a human approval, with their full text, newest first. A human reviews them here, then approves them (approve_message), corrects them (update_draft) or cancels them (cancel_message).

Access

Key: an Escouade Mail key with read or approve.
Space: any space, verified or not.
Changes nothing: yes, it only reads.
Safe to replay: yes.

Parameters

Parameter	Type	Required	Description
`inbox_id`	string	no	A single inbox (inb_…).
`cursor`	string	no	Cursor of the next page: the next_cursor value from the previous call.
`limit`	integer	no	Number of items returned (20 by default).

Call it

Terminal

curl -s https://api.subagent.fr/v1/list_drafts \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{}'

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