v1

latestOpenAPI 3.0.02026-07-14866188.2 KB

Agents

Create a new AI agent account

Creates an agent sub-account with APort passport, multicurrency wallet, and payment pointer

post/v0.2.4/agents/create

Request body

namestring required

Agent name

descriptionstring

Agent description

emailstring email

Agent email (auto-generated if not provided)

subAccountstring

Sub-account identifier

regionsstring[]

Allowed regions (ISO country codes)

metaobject

Additional metadata

interledgerWalletAddressstring

Custom Interledger wallet address/payment pointer

Example request

{
  "name": "PaymentBot",
  "description": "AI Agent for processing payments",
  "email": "agent-123@agents.chimoney.io",
  "limits": {
    "USD": {
      "maxPerTx": 10000,
      "dailyCap": 100000
    },
    "CAD": {
      "maxPerTx": 10000,
      "dailyCap": 100000
    },
    "NGN": {
      "maxPerTx": 10000,
      "dailyCap": 100000
    },
    "MXN": {
      "maxPerTx": 10000,
      "dailyCap": 100000
    },
    "refundAmountMaxPerTx": 5000,
    "refundAmountDailyCap": 50000
  },
  "capabilities": [
    "finance.payment.charge"
  ],
  "regions": [
    "US"
  ],
  "interledgerWalletAddress": "myagent-custom",
  "initialFunding": 100
}

Response

Agent created successfully

statusstring

Example response

{
  "status": "success"
}