Agents
Fund Agent
Add float to an agent’s account
POST
Adds float balance to an agent’s account. System admins can fund any agent. Super-agents can only fund their sub-agents.
Request
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)Path Parameters
string
required
Agent UUID to fund (e.g.,
agent_abc123)Body Parameters
string
required
Amount to add (e.g.,
500000.00 or 500000)string
Funding description/reference
Response
boolean
Whether funding succeeded
string
Funding transaction ID
string
Agent’s new float balance
Examples
Funding Sources
OLIVE Admin
System admin funds from OLIVE pool
Super-Agent
Super-agent transfers own float to sub-agent
Permissions
Errors
Authorizations
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Path Parameters
Agent ID
Body
application/json
Fund amount
Accepts decimal format like "1289.00" or "1289"
Response
OK
The response is of type object.