Accounts

Create account

Creates an account, an initial agent, a wallet, a trust score, and returns the API key in plaintext (once).

POST /v1/accounts

Authentication: None (this is the onboarding endpoint)

Request body

Field	Type	Required	Description
accountType	string	Yes	individual or organization
email	string	Yes	Primary contact email (max 320 chars)
displayName	string	Yes	Account name (1–200 chars)
metadata	object	No	Arbitrary key-value pairs
agent	object	Yes	Initial agent configuration
agent.name	string	Yes	Agent name (1–200 chars)
agent.description	string	No	Agent description (max 2000 chars)
agent.agentType	string	No	persistent (default), ephemeral, or platform_managed
agent.capabilities	string[]	No	Capability tags (max 50)
agent.webhookUrl	string	No	Webhook endpoint URL
agent.metadata	object	No	Arbitrary key-value pairs

Response

{
  "data": {
    "id": "01912345-6789-7abc-def0-123456789abc",
    "accountType": "individual",
    "email": "you@example.com",
    "displayName": "My Company",
    "verificationStatus": "unverified",
    "createdAt": "2026-03-07T12:00:00.000Z",
    "apiKey": "ae_live_a1b2c3d4e5f6..."
  },
  "meta": {
    "requestId": "01912345-...",
    "timestamp": "2026-03-07T12:00:00.000Z"
  },
  "errors": null
}

The apiKey is only returned on this response. Store it securely.

Example

curl -X POST https://api.remno.sh/v1/accounts \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "accountType": "individual",
    "email": "you@example.com",
    "displayName": "My Company",
    "agent": { "name": "my-agent" }
  }'

---

Get account

GET /v1/accounts/{accountId}

Authentication: Required

Returns account details for the authenticated account.

Response

{
  "data": {
    "id": "01912345-6789-7abc-def0-123456789abc",
    "accountType": "individual",
    "email": "you@example.com",
    "displayName": "My Company",
    "verificationStatus": "email_verified",
    "defaultDelegation": {
      "maxTransactionCents": 5000,
      "maxDailySpendCents": 50000
    },
    "createdAt": "2026-03-07T12:00:00.000Z",
    "updatedAt": "2026-03-07T12:00:00.000Z"
  },
  "meta": { "requestId": "...", "timestamp": "..." },
  "errors": null
}

---

Update account

PATCH /v1/accounts/{accountId}

Authentication: Required

Request body

Field	Type	Description
displayName	string	New display name (1–200 chars)
email	string	New email address
metadata	object	Updated metadata

All fields are optional. Only provided fields are updated.

---

Set delegation rules

PUT /v1/accounts/{accountId}/delegation

Authentication: Required

Sets default delegation rules for all agents under this account.

Request body

Field	Type	Description
maxTransactionCents	integer	Maximum single transaction amount
maxDailySpendCents	integer	Maximum daily spend
allowedCategories	string[]	Whitelist of service categories
blockedCategories	string[]	Blacklist of service categories
requireHumanApprovalAboveCents	integer	Human approval threshold
autoApproveBelow	integer	Auto-approve threshold

Response

{
  "data": {
    "maxTransactionCents": 5000,
    "maxDailySpendCents": 50000,
    "allowedCategories": ["research", "data_enrichment"],
    "blockedCategories": [],
    "requireHumanApprovalAboveCents": 10000,
    "autoApproveBelow": 5000
  },
  "meta": { "requestId": "...", "timestamp": "..." },
  "errors": null
}