AgentiSend

Purpose: see how much of this key's send budget is left, when it refills, and its per-minute ceiling. Read it before a batch, and after an agent_budget_exceeded refusal. NOT for: changing any of it. set_limit only lowers; raising is the account owner's. Returns: budget, consumed, remaining, the period and when it resets, and the per-minute ceiling with its current window.

get_agent_budget

Purpose: read the account's standing — ok, warning, throttled or paused — and the reasons behind it. Check it first when a send fails with trust_paused. NOT for: changing it. Standing follows delivery outcomes; nobody sets it directly. Returns: the state, the reasons, and when it is next reviewed.

get_trust_standing

Purpose: see the saved groups of contacts, the rules that define them, and how many people each currently matches. NOT for: sending to one. Who receives a broadcast is a person's decision. Returns: each segment with its rules and current size.

list_segments

Purpose: look up the people this account already has a relationship with. Pass an email to find one. NOT for: finding addresses to contact for the first time. This product has no feature for that and will not grow one. Returns: each contact with its properties, newest first.

list_contacts

Purpose: find messages, newest first, optionally filtered by status. NOT for: analytics or counting — it pages rows, it does not aggregate. Returns: data, has_more, and next_cursor. Page again by passing next_cursor as cursor; when has_more is false you have everything.

list_emails

Purpose: read your held actions in any state — pending, approved, rejected, killed — and find out what a person decided and why. NOT for: reading what a held message said; tools see shapes, not contents. Returns: each action with its state, decision time, the reason given, and a shape of its payload. Filter by state, or omit it for everything. list_pending_approvals is this list narrowed to what is still waiting.

list_agent_actions

Purpose: see which of your actions are waiting on a person, newest first. NOT for: deciding one — no tool approves or rejects — or reading a held message's contents, which stay out of reach by design. Returns: each action's id, kind, age and a shape of what it holds: recipient counts, whether there is a subject, whether there is a body.

list_pending_approvals

Purpose: see the domains this account can send from and where each one stands. Call it before sending from an address you have not used. NOT for: the DNS records of one domain (get_domain) or re-checking them (verify_domain). Returns: each domain with its id, region, status and when it last verified.

list_domains

Purpose: see which addresses this account will not send to, and why each one is on the list. Pass an email to check a single address. NOT for: a general contact list (list_contacts). Returns: each row with its id, address, level and origin — bounce, complaint or added by hand. This answers "why did that one never arrive?" before you retry it.

list_suppressions

Purpose: see the templates on this account and which version of each is live. NOT for: rendering one (render_template) or making a draft live (publish_template). Returns: each template with its current published version number. One with no published version cannot be sent yet.

list_templates

Purpose: see where events are delivered, what each endpoint subscribes to, and whether it is disabled. NOT for: reading signing secrets. They are shown once at creation and never again — a listing that returned them would let every reader forge deliveries. Returns: each endpoint with its url, events and state.

list_webhooks

Purpose: lower the period budget or the per-minute ceiling on a key of this account — cap a job before it runs, or stand a key down after a mistake. NOT for: raising either one. A value above what the key has now is refused with human_action_required: that is the account owner's decision, made in the console. An agent_budget_exceeded or rate_ceiling_exceeded refusal is not cured here — wait for the period, or ask a person. Returns: the key id and confirmation the new, lower limits are stored.

set_limit

Purpose: move a scheduled — or canceled — message to a new send time. NOT for: a settled message. Sent, bounced, failed, complained and suppressed cannot be moved, and the refusal names the status. Returns: the message id, its status and the new scheduled time.

reschedule_email

Purpose: find out exactly what a send would do, without doing it. Runs every gate a real send runs — validation, sending domain, sandbox, trust, suppression, budget, loop guard, content scan. NOT for: sending. Nothing leaves and no budget is spent, ever. Free and unlimited on purpose. Returns: the same ok/error POST /emails would return for the same payload, plus each gate's own verdict, and simulated: true when every recipient is a simulator address.

preflight_email

Purpose: make a template's draft the version send_email uses. NOT for: editing. Published versions are immutable; publishing again makes the next one, so nothing already sent can change under you. Returns: the template id and the new version number.

publish_template

Purpose: re-read the public DNS for a domain and report which records are in place. NOT for: creating records. Publishing DNS is done wherever the domain is hosted, by whoever runs it. Returns: the domain's status and every record's verdict. A domain with nothing published yet stays pending rather than failing: DNS takes minutes to a day or two to spread, and calling that a failure would make you give up on a domain that is about to work. Accepts id or domain_id.

verify_domain

Purpose: register an endpoint to receive event deliveries. NOT for: retrieving a secret you lost. Store the signing secret when you get it. Returns: the endpoint and its signing secret, ONCE. Verifying that signature is the only way a receiver can tell a real delivery from anything else.

create_webhook

Purpose: remove an endpoint for good. Deliveries stop immediately and its history stops being reachable. NOT for: pausing one. Disabling keeps the endpoint and its secret; delete it when it is genuinely gone. Returns: the id and confirmation it is gone. Nothing is re-delivered elsewhere.

delete_webhook

Purpose: see exactly what a template produces with your values, and find out which variables it needs. NOT for: sending. Nothing leaves. Returns: the rendered HTML. An unknown or missing variable comes back named, with the fix, instead of shipping a half-filled email.

render_template

Purpose: send one email now, or at a time you name. Takes one recipient or a list. NOT for: checking whether a send would work (preflight_email), sending many different messages at once (send_batch), or asking a person first (request_approval). Returns: the message id and its status, immediately. Delivery happens after; get_email has the outcome. Refusals name the gate and the cure: validation_error lists the bad fields, domain_not_verified points at verify_domain, suppressed_recipient says the address asked not to be contacted. Addresses ending in @simulator.agentisend.com cost nothing, reach nobody, and work before any domain is verified.

send_email

Purpose: send up to 100 different messages in one call. NOT for: one message to many recipients — that is send_email with a list of addresses, and it costs one unit, not a hundred. Returns: sent, failed, and one result per item IN THE ORDER YOU SENT THEM, each carrying the same code and fix a single send would have given. One bad address does not fail the batch. Each accepted item costs one unit of budget.

send_batch

Purpose: stop sending to an address, or to a whole domain (pass "@example.com"). Use it the moment someone asks not to be contacted. NOT for: undoing one (remove_suppression). Returns: the row that now blocks that address. Adding is always allowed and always safe; it is the direction that protects the account.

add_suppression

Purpose: the one read to make before deciding anything, and again after any refusal. Answers who you are and what you may do. NOT for: changing anything. Returns: the account and key, the scopes held, the tools those scopes can call, budget consumed and remaining with its refill time, the per-minute ceilings, whether the kill switch is down, the account trust standing, and can_send_now as the summary.

whoami

Purpose: find out what is holding a send. Name an email_id for one message, or omit it to ask what is blocking this key and this account right now. NOT for: the outcome of a delivered message (get_email) or what to do about a bounce (explain_email). Returns: every blocker, each with why, the fix, and is_normal_wait — the field that matters, because a scheduled send and a paused key look identical without it. When nothing is blocking, it says so and says what it checked rather than implying a message exists.

why_was_this_not_sent