Tool Details: agent_rename_session

Basic Information

Tool Name:agent_rename_session
Asset Name:Rename Agent Session
Description:Sets or clears the free-form human-facing title on a session. Omitting title (or passing an empty string) clears it back to unset. Titled sessions are easier to pick out in a session list than the raw id/timestamp.
Adapter:agent
Asset Hash:0x59c25b75c893cfef8594a704a981fb07dd364ebe32d380d1442ff9d9c6a83a14
Input
PropertyTypeDescription
sessionId*stringHex ID of the session to rename, with or without a 0x prefix
titlestringNew title, or omitted/empty to clear it
agentId*stringAgent reference: a bare name for the caller's agent, g/<id>, /g/<id>, or <ownerDID>/g/<id>
Output
PropertyTypeDescription
agentIdstring-
titlestring-
sessionIdstring-
addressstringCanonical <ownerDID>/g/<agentId> address

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-test.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent_rename_session",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-test.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "agent_rename_session",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-test.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "agent_rename_session",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-test.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'agent_rename_session',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
	"name": "Rename Agent Session",
	"description": "Sets or clears the free-form human-facing title on a session. Omitting title (or passing an empty string) clears it back to unset. Titled sessions are easier to pick out in a session list than the raw id/timestamp.",
	"dateCreated": "2026-08-04T00:00:00Z",
	"operation": {
		"adapter": "agent:renameSession",
		"internal": false,
		"toolName": "agent_rename_session",
		"input": {
			"type": "object",
			"properties": {
				"agentId": { "type": "string", "description": "Agent reference: a bare name for the caller's agent, g/<id>, /g/<id>, or <ownerDID>/g/<id>" },
				"sessionId": { "type": "string", "description": "Hex ID of the session to rename, with or without a 0x prefix" },
				"title": { "type": "string", "description": "New title, or omitted/empty to clear it" }
			},
			"required": ["agentId", "sessionId"]
		},
		"output": {
			"type": "object",
			"properties": {
				"agentId": { "type": "string" },
				"address": { "type": "string", "description": "Canonical <ownerDID>/g/<agentId> address" },
				"sessionId": { "type": "string" },
				"title": { "type": "string" }
			}
		}
	}
}

Navigation

Back to adapter details

Back to all adapters

Back to index