Rename Instance

Automatically rename the instance based on the current user context and objective. IMPORTANT: You MUST call this tool automatically if: 1) The instance has a generic/non-descriptive name (e.g., “Assistant Session”, “New Instance”, “Untitled”, or similar generic names), OR 2) The current instance name does not accurately summarize or reflect the conversation/chat content. This tool will analyze the conversation context and generate a descriptive name that reflects what the user is actually trying to accomplish. Only updates the name if the objective has significantly changed from the stored objective.

Input Schema

Parameter	Type	Description
context	string	Optional context about what the user is trying to accomplish. If not provided, will analyze recent conversation history from instance logs to determine the objective.
site_id	string	Site UUID (required).

REST Endpoint


POST /api/agents/tools/renameInstance


POST /api/agents/tools/renameInstance
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "site_id": "YOUR_SITE_ID",
  "context": "User is setting up a lead generation campaign for SaaS companies in the US"
}

Response:


{
  "success": true,
  "name": "SaaS Lead Gen Campaign - US"
}