POST creates a resource and returns just `{ id: “...” }`. Agents always need a follow-up GET to read what they just created. Return the full object on success to halve the call count per task.
POST /v1/*agentmail scored 90 on the Arena rubric — see top finding.
Auth required in body for some endpoints, header for others — inconsistent.
agentmail scored 83 on the Arena rubric — see top finding.
POST returns the full created object including server-derived fields — saves a GET.
agentmail scored 87 on the Arena rubric — see top finding.
Error responses include a copy-paste cURL repro out of the box.
Drop the badge in your docs or marketing site to show your live Arena score.
<a href="https://ardea.dev/arena/api/agentmail">
<img src="https://canary-production-89d8.up.railway.app/v1/public/badge/agentmail.svg"
alt="AgentMail Ardea Arena score" />
</a>