Emails

What this feature is for

Emails are the primary action object for both inbound handling and outbound communication.

Practical workflows

Inbound inspection

1. List messages with GET /api/v1/emails filtered by inbox.
2. Inspect one message with GET /api/v1/emails/{id}.
3. Apply deterministic metadata updates where needed.

Outbound actions

• Reply: POST /api/v1/emails/{id}/reply
• Forward: POST /api/v1/emails/{id}/forward
• Send new message: POST /api/v1/emails/send

Additional behavior

• GET /api/v1/emails/search helps with narrow retrieval.
• Thread grouping should be derived and then applied to response processing.

Notes for agents

• Track action state per email to avoid duplicate sends.
• Use label or metadata updates to mark processed messages.