Account8

Address Notes7

Agent7

Agent Connections13

Agent Networks8

Changes1

CLI6

Contacts13

Credentials13

Credits2

Discovery2

Domains10

Email Rules7

Emails14

Endpoints8

Filters4

Functions40

Inbox7

Interactions4

Mailbox access6

Memories4

Organization settings12

Organizations3

Projects9

Repeating Sends5

Roles and members18

Routes6

Search1

Sending20

Service1

Stats3

Templates3

Threads6

Wake11

Webhook Deliveries3

Routes

Simulate routing for a recipient

Changed on Oct 21, 2026

Resolves where an inbound email to recipient would be delivered, with a trace of every rule evaluated and why. Read-only; creates nothing.

post/routes/simulate

Request

Base URL
https://api.primitive.dev/v1
URL
https://api.primitive.dev/v1/routes/simulate
Auth
HTTP bearer

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

recipientstring required

event_typestring

Event type to model; defaults to email.received.

Response

Routing decision

successtrue required

Changes

Oct 21, 20260360ea8d4f3d Revision changes
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
Oct 21, 20265279a7bed7ac Revision changes
- warning
  added the new archive_busy enum value to the / response property for the response status
- warning
  added the new archive_busy enum value to the / response property for the response status
- warning
  added the new archive_invalid enum value to the / response property for the response status
- warning
  added the new archive_invalid enum value to the / response property for the response status
- warning
  added the new archive_limit_exceeded enum value to the / response property for the response status
- warning
  added the new archive_limit_exceeded enum value to the / response property for the response status
- warning
  added the new archive_unsafe_path enum value to the / response property for the response status
- warning
  added the new archive_unsafe_path enum value to the / response property for the response status
- warning
  added the new archive_unsupported enum value to the / response property for the response status
- warning
  added the new archive_unsupported enum value to the / response property for the response status
- warning
  added the new attachment_name_ambiguous enum value to the / response property for the response status
- warning
  added the new attachment_name_ambiguous enum value to the / response property for the response status
- warning
  added the new attachment_not_archive enum value to the / response property for the response status
- warning
  added the new attachment_not_archive enum value to the / response property for the response status
- warning
  added the new latest_message_mismatch enum value to the / response property for the response status
- warning
  added the new latest_message_mismatch enum value to the / response property for the response status
- warning
  added the new latest_message_thread_unresolved enum value to the / response property for the response status
- warning
  added the new latest_message_thread_unresolved enum value to the / response property for the response status
- warning
  added the new sent_mail_search_unavailable enum value to the / response property for the response status
- warning
  added the new sent_mail_search_unavailable enum value to the / response property for the response status
- warning
  added the new thread_busy enum value to the / response property for the response status
- warning
  added the new thread_busy enum value to the / response property for the response status

Operation history (11 revisions)