Skip to main content

​
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

FieldTypeDescription
customerIdstringThe customer this agent belongs to
externalIdstringYour unique identifier for the agent
namestringHuman-readable name
statusstringactive or suspended

​
Agent Status

StatusDescription
activeAgent can access cards and make purchases
suspendedAgent 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