Deploy an agent
Create a new agent with a server-managed Solana wallet.409 Conflict if an agent with the same ID already exists for this owner.
API Reference
Agents API
Provision and manage agents, wallets, and spending policies.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Provision and manage agents, wallets, and spending policies.
POST /v1/agents/deploy?owner=<wallet>
{
"agentId": "my-agent",
"dailyBudget": "25.00",
"maxPerPayment": "2.00"
}
{
"agent": {
"agentId": "my-agent",
"walletAddress": "8mK...pQ2",
"createdAt": "2026-04-22T10:00:00Z"
},
"mcpConfig": {
"command": "npx",
"args": ["-y", "@usefloat/mcp@latest"]
}
}
409 Conflict if an agent with the same ID already exists for this owner.
GET /v1/agents/:agentId/balance?owner=<wallet>
{
"agentId": "my-agent",
"walletAddress": "8mK...pQ2",
"balance": "18.42",
"currency": "USDC"
}
GET /v1/agents/:agentId/policy?owner=<wallet>
{
"agentId": "my-agent",
"policy": {
"dailyBudget": "25.00",
"maxPerPayment": "2.00",
"cooldownSeconds": 0,
"allowedServices": []
}
}
POST /v1/agents/:agentId/policy?owner=<wallet>
{
"dailyBudget": "50.00",
"maxPerPayment": "5.00",
"cooldownSeconds": 60,
"allowedServices": ["float-image-gen"]
}
POST /v1/agents/:agentId/allocate?owner=<wallet>
{
"amount": "10.00"
}
POST /v1/agents/:agentId/kill?owner=<wallet>
POST /v1/agents/:agentId/resume?owner=<wallet>
POST /v1/agents/:agentId/rename?owner=<wallet>
{
"displayName": "Research Bot"
}
GET /v1/agents/:agentId/spend-history?owner=<wallet>&limit=20
{
"payments": [
{
"id": "pay_abc123",
"service": "Float Image Generation",
"amount": "0.14",
"currency": "USDC",
"status": "confirmed",
"timestamp": "2026-04-22T10:30:00Z"
}
]
}
POST /v1/link-sessions
{
"token": "lnk_...",
"linkUrl": "https://app.usefloat.xyz/link?token=lnk_...",
"expiresAt": "2026-04-22T10:15:00Z"
}
GET /v1/link-sessions/:token
POST /v1/link-sessions/:token/complete