Skip to main content
PATCH

Authorizations

Authorization
string
header
required

User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.

Headers

x-signature
string
required

Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.

x-timestamp
string
required

Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.

Path Parameters

id
string
required

Body

application/json

OpenAPI schema McpUpdateAgentBodyDto; agentId is taken from the path.

name
string

Display name (max 20 characters)

Maximum string length: 20
description
string | null
imageUrl
string | null
tags
string[]
personalization
object
isPublic
boolean

true asks to list the agent: an approved agent is listed now; otherwise it stays private and goes to staff review (listingStatus pending-review). false makes it private (and cancels a pending review).

feeConfiguration
object
status
enum<string>
Available options:
DRAFT,
ACTIVE,
PAUSED,
DELETED
closeActiveTrades
boolean

When setting status to PAUSED: required for private agents (true = close owner trades first, false = keep open). Optional for public agents.

strategyDescription
string
marketplacePricingModel
enum<string>
Available options:
subscription,
success-fee,
both,
free
marketplaceMonthlyPrice
number
Required range: x >= 0
marketplaceSuccessFeePercent
number
default:20
Required range: 0 <= x <= 22
listingStatus
enum<string>

Staff only. A change is rejected (LISTING_STATUS_STAFF_ONLY); the current value is ignored. To list the agent send isPublic: true, which starts a staff review.

Available options:
pending-review,
beta,
public,
rejected,
shadow-monitoring
betaStartDate
string<date-time>

Ignored. The agent beta stage was removed.

maxBetaUsers
number
Required range: x >= 1
maxCohortEntryNotionalUsd
number | null

Creator ceiling on total entry notional for one signal, owner included. On Hyperliquid this is margin times leverage. Omit for no creator ceiling. Null clears it. Zero is rejected.

Required range: x > 0
riskLevel
enum<string>
Available options:
low,
medium,
high
performanceStats
object

Ignored. Performance numbers come from real trades only.

Ignored. Featured is set by EchoZero staff.

Ignored. Featured order is set by EchoZero staff.

inboundWebhookUrl
string
signalSourceKind
enum<string>
Available options:
webhook,
signal_group
connectedChannels
object[]
signalDetectionRule
object
signalExecutionDefaults
object

Agent trading defaults (whole object, replaces the stored value). Trade-card fields (tradeType, tradeMode, defaultTradeAllocationUsd, takeProfitLadder, timeStopMins) are validated on save.

parserAiMode
enum<string>

Per-agent hybrid parser: inherit (server env), off, shadow, or fallback.

Available options:
inherit,
off,
shadow,
fallback
membershipGated
boolean
gatedPlatform
enum<string>

Required when membershipGated is true. Telegram or Discord. Independent of connected channels.

Available options:
telegram,
discord
externalSignupUrl
string
rotateInboundWebhookSigningSecret
boolean

When true and signalSourceKind is webhook, rotate inbound signing secret (returned once on the agent payload)

personality
object | null

API personality override for subscriber chat. Stored as personalization.apiOverride and takes precedence over portal defaults. Pass null to clear.

agentVenue
enum<string>

Rejected if changed after create (venue lock is immutable).

Available options:
JUPITER,
HYPERLIQUID,
ONEINCH,
ALL_PLATFORMS
agentChain
enum<string>
Available options:
SOLANA,
CHILIZ,
FLOW,
ARBITRUM,
BASE,
HYPERLIQUID
maxConcurrentPositions
number
Required range: x >= 1
maxEntriesPerTrade
number
Required range: x >= 1
tradeVisibility
enum<string>

Who sees this agent's live trades, and when. Switching away from SUBSCRIBERS_FIRST clears tradeRevealDelaySeconds.

Available options:
PUBLIC_IMMEDIATELY,
SUBSCRIBERS_FIRST,
SUBSCRIBERS_ONLY
tradeRevealDelaySeconds
enum<number> | null

Seconds before non-subscribers see live trades (30, 60, 300, 900 or 3600). Only with SUBSCRIBERS_FIRST (current or sent in the same call); null resets to the default (60).

Available options:
30,
60,
300,
900,
3600

Response

Updated agent.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload