v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB
Functions

Send a test invocation

Sends a real test email from a Primitive-controlled sender to a local-part on one of the org's verified inbound domains. By default the recipient is a synthetic __primitive_function_test+<random>@<domain> address on a domain selected to route to the function. Scoped functions use their scoped domain; fallback functions use a domain that has no enabled domain-scoped endpoint. Pass local_part to override and exercise routing logic that branches on a specific recipient (the common pattern when one function handles multiple inboxes like summarize@ and action@). The function fires through the normal MX delivery path, so reply / send-mail calls from inside the handler against the inbound's email.id work the same as in production. Returns immediately after the send is queued; the invocation appears on the function's invocations list within a few seconds.

Requires that the function is currently deployed. Returns 422 if the function is in pending or failed state, or if the org has no verified inbound domain to receive the test mail. Returns 400 if local_part is set to a value that does not match the local-part character set.

post/functions/{id}/test

Headers

Idempotency-Keystring

Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.

Request body

local_partstring

Override the synthetic local-part. When set, the test email is sent to <local_part>@<picked-domain> instead of the default __primitive_function_test+<random>@<picked-domain>. Must start with an alphanumeric and contain only letters, digits, dots, plus signs, hyphens, or underscores; 1-64 characters total.

Example request

{
  "local_part": "summarize"
}

Response

Test send queued

successtrue required