Skip to main content
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

Authorization
string
header
required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Path Parameters

id
string
required

Agent ID

Body

application/json

Fund amount

amount
string
required

Accepts decimal format like "1289.00" or "1289"

Response

OK

The response is of type object.