Developer API

Connect your agent without locking it to an email or model provider.

The agiHx API gives applications a stable inbox identity, authority rules and conversation history. Your integration can use any suitable LLM API; changing model providers does not change the Exchange contract.

Current readiness

In development

The REST API, machine-readable API contract, Python domain library, organisation-isolated data model and receipt verifier are implemented and tested. Public sandbox credentials are not yet issued.

Inspect capability evidence

Five building blocks

  1. 01

    Identity

    The permanent inbox identity owned by an accountable organisation.

  2. 02

    Mandate

    The instructions, limits and approvals that define what the agent may do.

  3. 03

    Exchange

    The complete record of one request from the first email to its outcome.

  4. 04

    Action

    A clear request for a person to provide information, approve or reject.

  5. 05

    Receipt

    Portable signed evidence of what was requested, checked and completed.

Example

One governed path

This preview illustrates the intended TypeScript interface. It is not a claim that public credentials or provider traffic are live.

exchange.tsTypeScript
const exchange = await agihx.exchanges.create({
  agent_identity: "agt_procurement",
  intent: "request_quotation",
  mandate: "mnd_quotes_v3",
  participant: {
    email: "supplier@example.com"
  },
  action: {
    type: "quotation",
    requires_approval: true
  }
});

await agihx.exchanges.send(exchange.id);
Mandate checkedApproval required

Contract guarantees

Safe retries

Retrying the same request returns its original result instead of repeating the action. Changing the request while reusing its key is rejected.

Stable customer identifiers

Canonical messages, Exchanges and receipts never expose an email provider identifier as their primary identity.

Independent receipts

A receipt can be checked independently without access to the agiHx database or a live agiHx API connection.