Agents
Ask the Merchant OS (Orchestrator -> specialist agent -> approval gate)
The Orchestrator Agent routes the request to Business Intelligence, Product Discovery, Supply Intelligence, Pricing Intelligence, Growth Strategy or the PayPal Transaction Agent. Every tool call is permission-checked, traced and recorded. Nothing that moves money happens without a human approval.
Authorization
HTTPBearer AuthorizationBearer <token>
JWT access token
In: header
Query Parameters
merchant_id?|
Optional merchant to act on. Must be one you are a member of.
Format
uuidHeader Parameters
X-Merchant-ID?string|null
Request Body
application/json
agent?|
Force a specialist; omit to let the Orchestrator Agent decide.
Match
^(business_intelligence|product_discovery|supply_intelligence|pricing_intelligence|growth_strategy|paypal_transaction)$message*string
Length
2 <= length <= 2000params?
Optional structured inputs, e.g. product_ids.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/v1/agents/execute" \ -H "Content-Type: application/json" \ -d '{ "message": "string" }'{ "data": {}, "meta": {}, "success": true}