Agents Avatar

API endpoints for Agents Avatar

DELETE /api/agents/{agent_id}/avatar

RemoveAvatar removes the avatar from an agent.

Deletes the avatar file from storage and clears the agent's avatar URL. Returns 200 with the updated agent on success.

Response Codes

Status Code Description
200 Success
404 Resource not found
500 Internal server error

Success

Response response.AgentResponse

Agent

Property Type Description
id integer (int64) Unique agent identifier
workspace_id integer (int64) ID of workspace that owns this agent
name string Agent's display name
description string | null Description of agent's purpose and capabilities
status string Agent status: active, draft, published, or archived
color string Hex color code for agent UI theming
avatar string | null URL to agent's avatar image
system_prompt string | null System instructions that define agent's personality and behavior
instruction_template string | null Template for formatting user instructions
llm_integration_id integer (int64) | null ID of the LLM integration to use
llm_config object Configuration for LLM provider (temperature, max_tokens, etc.)
storage_integration_id integer (int64) | null ID of the vector storage integration for RAG
storage_config object Configuration for vector storage provider
health_status object Detailed health check results by capability
healthy boolean | null Overall health status (true if all capabilities healthy)
health_checked_at string (date-time) | null Timestamp of last health check
contact_config object Configuration for contact capture forms
created_at string (date-time) Timestamp when agent was created
updated_at string (date-time) Timestamp when agent was last updated