Valta Docs
Agents API
POST /agents
Creates a custom agent wallet for the authenticated user.
Body
| Field | Type | Required |
|---|---|---|
| name | string | yes |
| type | string | no |
| description | string | no |
bash
curl -X POST https://valta.co/api/v1/agents \
-H 'x-api-key: vlt_live_...' \
-H 'Content-Type: application/json' \
-d '{"name":"Treasury Bot","type":"custom"}'
GET /agents
Lists marketplace subscriptions and custom wallets. Supports limit and offset.
GET /agents/:id
Returns wallet row metadata for an owned agent id.
PATCH /agents/:id
Updates fields such as spendLimit on the underlying wallet row.
POST /agents/:id/freeze
Sets status to frozen and writes a freeze log entry.
POST /agents/:id/unfreeze
Restores an agent to active when permitted.
DELETE /agents/:id
Deletes a custom agent wallet you own.
SDK equivalent
ts
import Valta from 'valta-sdk'
const valta = new Valta({ apiKey: process.env.VALTA_API_KEY! })
await valta.agents.create({ name: 'Bot', type: 'custom' })