This endpoint is used to update the info of an agent all at once.
Request Parameters
The unique identifier for the agent (UUID format)
Optional new name for the agent
Optional new description for the agent
Optional new image URL for the agent
Optional new public status for the agent. Accepts true, false, or "true" as string
Optional fee configuration objectShow agentFees properties
self (object, optional): Fee configuration for self
fee (number): Fee amount (flat fee or basis points depending on type)feeAddress (string): Address to receive the feetype (string): Fee type, must be "FLAT" or "BPS"
owner_flat (object, optional): Flat fee configuration
fee (number): Flat fee amountfeeAddress (string): Address to receive the feetype (string): Fee type, must be "FLAT"
owner_bps (object, optional): Basis points fee configuration
fee (number): Fee in basis pointsfeeAddress (string): Address to receive the feetype (string): Fee type, must be "BPS"
Response
Status of the operation (e.g., “success”)
Success message indicating the agent was updated successfully
The agent ID that was updated (UUID format)
The updated agent name (if provided)
The updated agent description (if provided)
The updated agent image URL (if provided)
The updated agent public status (if provided)
Array of fee configuration objects that were set for the agent
Fee partner identifier (e.g., “self”, “owner_flat”, “owner_bps”)
Fee amount (flat fee or basis points depending on feeType)
Ethereum address to receive the fee
Fee type: “FLAT” for flat fees or “BPS” for basis points
Behavior
- Updates the specified agent information in our internal database
- Allows updating multiple fields at once (name, description, imageUrl, isPublic, agentFees)
Authentication
B2B JWT token OR Privy authentication token and headers
When using Privy authentication token, include the following header:
x-privy-id-token: Privy ID token
{
"agentId": "2fe35eeb-5aa6-4564-94c2-2ce44e65625d",
"name": "New Name",
"description": "New Description",
"imageUrl": "https://example.com/image.png",
"isPublic": true,
"agentFees": {
"self": {
"fee": 1.5,
"feeAddress": "0x56d0573C786d3DB...",
"type": "BPS"
}
}
}
{
"status": "success",
"message": "Agent 2fe35eeb-5aa6-4564-94c2-2ce44e65625d updated successfully",
"agentId": "2fe35eeb-5aa6-4564-94c2-2ce44e65625d",
"name": "New Name",
"description": "New Description",
"imageUrl": "https://example.com/image.png",
"isPublic": true,
"feeData": [
{
"partner": "self",
"fee": 1.5,
"feeAddress": "0x56d0573C786d3DB...",
"feeType": "BPS"
}
]
}
