Skip to main content
POST
Upload agent avatar from base64 image data

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
imageData
string
required

Base64 image bytes. Data URLs such as data:image/png;base64,... are also accepted.

Example:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB..."

mimeType
string

Required when imageData is raw base64. Ignored when imageData is a data URL.

Example:

"image/png"

Response

Uploaded agent avatar URL.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload