OpenIntegrations/docs/en/md/Slack/Channel-management/Set-channel-goal.mdx

---
sidebar_position: 12
description: Set channel purpose and other functions to work with Slack in the Open Integration Package, a free open-source integration library for 1C:Enterprise 8, OneScript and CLI
keywords: [1C, 1С, 1С:Enterprise, 1С:Enterprise 8.3, API, Integration, Services, Exchange, OneScript, CLI, Slack]
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Set channel purpose
 Sets the channel purpose (description)



`Function SetChannelGoal(Val Token, Val Channel, Val Purpose) Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Token | --token | String | ✔ | Bot token |
  | Channel | --channel | String | ✔ | Channel ID |
  | Purpose | --purpose | String | ✔ | Channel purpose |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Slack

<br/>




```bsl title="1C:Enterprise/OneScript code example"
    Token   = "xoxb-6965308400114-696804637...";
    Channel = "C08TMMCHZGR";
    Purpose = "TestGoal";

    Result = OPI_Slack.SetChannelGoal(Token, Channel, Purpose);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint slack SetChannelGoal \
             --token "***" \
             --channel "C08SXAZFUNT" \
             --purpose "TestGoal"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint slack SetChannelGoal ^
             --token "***" ^
             --channel "C08SXAZFUNT" ^
             --purpose "TestGoal"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "ok": true,
 "channel": {
  "id": "C07R448PZJ8",
  "name": "testconv2383f9a9-fc9f-4928-ba19-511c3b7e9c66",
  "is_channel": true,
  "is_group": false,
  "is_im": false,
  "is_mpim": false,
  "is_private": false,
  "created": 1728454513,
  "is_archived": false,
  "is_general": false,
  "unlinked": 0,
  "name_normalized": "testconv2383f9a9-fc9f-4928-ba19-511c3b7e9c66",
  "is_shared": false,
  "is_org_shared": false,
  "is_pending_ext_shared": false,
  "pending_shared": [],
  "context_team_id": "T06UD92BS3C",
  "updated": 1728454514526,
  "parent_conversation": null,
  "creator": "U06UG1CAYH2",
  "is_ext_shared": false,
  "shared_team_ids": [
   "T06UD92BS3C"
  ],
  "pending_connected_team_ids": [],
  "is_member": false,
  "topic": {
   "value": "TestTopic",
   "creator": "U06UG1CAYH2",
   "last_set": 1728454514
  },
  "purpose": {
   "value": "TestGoal",
   "creator": "U06UG1CAYH2",
   "last_set": 1728454514
  },
  "previous_names": []
 }
}
```