Agents

An Agent is an autonomous actor (AI or automation) that spends on behalf of a customer. Agents can be assigned cards and must declare intents before making purchases.

Creating an Agent

curl -X POST https://api.useproxy.ai/v1/agents \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_xxx",
    "externalId": "my-agent-123",
    "name": "Shopping Agent"
  }'

Agent Fields

Field	Type	Description
`customerId`	string	The customer this agent belongs to
`externalId`	string	Your unique identifier for the agent
`name`	string	Human-readable name
`status`	string	`active` or `suspended`

Agent Status

Status	Description
`active`	Agent can access cards and make purchases
`suspended`	Agent is temporarily blocked from spending

Policy Overrides

Agents can have policy overrides that take precedence over customer defaults:

{
  "policy": {
    "requireIntent": true,
    "limits": {
      "perAuth": 5000
    },
    "blockedMccs": ["7995"]
  }
}

Suspend an Agent

curl -X POST https://api.useproxy.ai/v1/agents/agent_xxx/suspend \
  -H "Authorization: Bearer your_api_key"

Next Steps

Cards

Issue cards to agents

Intents

Declare purchase intents

CardsVirtual spending instruments with policy controls

Getting Started

Concepts

Agents

Agents

Creating an Agent

Agent Fields

Agent Status

Policy Overrides

Suspend an Agent

Next Steps

Cards

Intents

​Agents

​Creating an Agent

​Agent Fields

​Agent Status

​Policy Overrides

​Suspend an Agent

​Next Steps

Cards

Intents

Agents

Creating an Agent

Agent Fields

Agent Status

Policy Overrides

Suspend an Agent

Next Steps