Set Conversation Purpose

Sets the purpose/description for a conversation

Usage #

// Import the typed helper
import { setConversationPurpose } from "@hotglue/sdk/slack";
const result = await client.execute({
...setConversationPurpose({
channel: string,
purpose: string,
}),
userId: "user_123",
});
// result is typed as SetConversationPurposeOutput
const result = await client.execute({
integration: "slack",
tool: "set_conversation_purpose",
userId: "user_123",
input: {
channel: string,
purpose: string,
},
});
// The agent will automatically use this tool when needed
const agent = new Agent({
tools: () => hotglueTools({
integrations: ["slack"],
userId: "user_123",
}),
});
await agent.generate("run the Set Conversation Purpose tool");

Required Permissions #

channels:manage

Input Schema #

channel string required

Channel ID

purpose string required

New purpose text (max 250 chars)

Output Schema #

ok bool required
purpose string

This tool calls: #

POST https://slack.com/api/conversations.setPurpose