create_key · Escouade Mail documentation

Create an agent’s key.

Creates the API key of one of the space’s agents (a script, another assistant, an automation). It is returned once only, in this response. It holds send and read by default, never approve: an agent does not approve its own sends. It can be limited to some inboxes and to a number of messages per day. A key is never written in an e-mail.

Access

Key: an Escouade Mail key with approve.
Space: a verified space.
Changes nothing: no, it acts.
Safe to replay: use an idempotency_key where the tool offers one.

Parameters

Parameter	Type	Required	Description
`name`	string	yes	Name of the agent, for example “agent-devis”.
`permissions`	list of string	no	Absent: send and read.
`inbox_ids`	list of string	no	The only inboxes open to the key. Absent: all of them, present and future.
`daily_cap`	integer	no	Cap on messages created per day. Absent: none.

Call it

Terminal

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

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