Send email
Email a report to yourself (the signed-in user). There is no recipient parameter: the message always goes to the account email of the user the call acts for (for a scheduled background run, the schedule creator). The Markdown body is rendered to email-safe HTML with a plain-text alternative and an “Sent by your Octospark agent” footer. Requires an active subscription on the team’s organisation (402 otherwise) and is capped at 5 emails per hour per user, counted in a window that opens on the first send (429 with Retry-After). Free: no credits are spent. Send an Idempotency-Key and reuse it with the same request after a lost response to get the original send back instead of a second email.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Reuse this key with the same request after a lost response. The original send is returned and no second email goes out.
1 - 200Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Body
Email subject line, 1-200 characters. Sent verbatim.
1 - 200Report body as Markdown, 1-50000 characters. Headings, paragraphs, bold/italic, links, bullet and numbered lists, block quotes and code are rendered to email-safe HTML; raw HTML is escaped, never rendered.
1 - 50000