Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

navigate_workspace

View as .md

Show a page in Escouade Mail.

Drives the workbench that is already open, without creating a new card. Reuse the instance_id from this conversation’s context. page=audiences, contacts or campagnes; performances with arguments.campaign_id for a selected campaign. A requested navigation may wait until the person finishes typing: do not claim it is already displayed. Sends nothing.

Access

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

Parameters

ParameterTypeRequiredDescription
pageone of jour, valider, fils, campagnes, audiences, contacts, boites, domaines, blocages, espace, performancesyesSection to display. jour (today) by default. performances with campaign_id shows that campaign’s results.
argumentsobjectnoRead arguments for the page: query to search for a contact, email for their record, campaign_id, audience_id, thread_id or message_id to open a detail. Sends nothing.
instance_idstringyesIdentifier of the active workbench, provided by its context. Never invent one, and never reuse one from another conversation.

Call it

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

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