Studio Project workflows for Slack messaging, conversations, users, and files
Slack is a business messaging platform for team communication, offering channels, direct messages, file sharing, and an extensible app/bot platform. The Slack Web API is Slack's primary HTTP API for interacting with a workspace programmatically — sending messages, managing channels, looking up users, and more.
This project provides OpenAPI specs for automating against the Slack Web API via an Integration Model. The -latest spec is a curated subset covering common CRUD for automation — see OpenAPIs below.
| Asset | Description |
|---|---|
| OpenAPIs/ | Slack Web API OpenAPI specs — curated -latest plus the full dated spec |
| Studio Projects/Slack Web API | 30 workflows covering common CRUD automation |
| Requirement | Version |
|---|---|
| Itential Platform | 6.x |
| Slack Web API | 1.7.0 (see OpenAPIs below for exact spec versions available) |
| Slack Web API Integration Model | Required to build automation against the OpenAPI specs |
Import one of the OpenAPI specs from OpenAPIs/ as an Integration Model in Admin > Integrations, then create an integration pointing at your Slack workspace.
Authentication is a bearer token in the Authorization header:
Authorization: Bearer <your-slack-token> Use a Slack bot token (xoxb-*) for bot operations, or a user token (xoxp-*) for user-delegated actions. Generate one from your Slack app configuration at https://api.slack.com/apps.
The instance's authentication/server properties should look like this once configured:
{
"authentication": {
"botToken": "<your-bearer-token>"
},
"server": {
"protocol": "https",
"host": "slack.com",
"base_path": "/api"
}
} | Spec | Version | Operations | Description |
|---|---|---|---|
slack_web_api-latest.json | latest (curated) | 61 | Trimmed to 61 of 174 upstream operations — see breakdown below |
slack_web_api-1.7.0.json | 1.7.0 | 174 | Full spec for the Slack Web API, version 1.7.0. |
slack_web_api-latest.jsonActively-maintained spec (x-vendor-api-version: 1.7.0). Trimmed to 61 of 174 upstream operations covering common CRUD for automation. The full upstream spec includes workspace admin tooling (admin.*, apps.*), app-development/UI features (views.*, dialog.open), the legacy Calls, Do Not Disturb, Stars, and Workflow Steps modules, OAuth flows, and other niche or internal-tooling endpoints — none of those are included here. Pull the full spec below if you need one of the excluded areas.
Resources included, by category:
chat.*)conversations.*)users.*)files.*)reactions.*)pins.*)usergroups.*)reminders.*)team.info) and token validation (auth.test)This pass also removed 61 per-operation security overrides that were exact duplicates of the spec's global security block (botToken), so securitySchemes now has a single, unambiguous global auth definition.
slack_web_api-1.7.0.jsonFull, unmodified vendor spec for the Slack Web API, version 1.7.0 (174 operations) — the vendor's complete API surface, preserved as-is. See slack_web_api-latest.json above for the curated subset if you just need common CRUD automation.
Backed by the Slack Web API:latest Integration Model (see slack_web_api-latest.json above). The project contains 30 workflows organized into 6 folders, one atomic workflow per API operation, covering the common-CRUD subset of the curated spec.
| Folder | Workflows | Scope |
|---|---|---|
| Messaging | Post, Update, Delete Message, Post Ephemeral Message, Schedule Message, Get Permalink | Sending and managing chat messages |
| Conversations | Create, List, Get Info, Get History, Get Replies, Get Members, Invite, Archive, Rename | Channel/conversation lifecycle |
| Users | List, Get Info, Lookup By Email, Get Presence, Get Profile, Set Profile | User lookup and profile management |
| Files | Upload, List, Get Info, Delete | File sharing |
| Reactions | Add, List, Remove | Emoji reactions on messages |
| Pins | Add, List | Pinned items in a conversation |
| Dependency | Notes |
|---|---|
Slack Web API:latest Integration Model | Import from slack_web_api-latest.json before importing the project |
Slack Web API integration instance | Create in Admin > Integrations with the connection properties above. Workflows are wired to an integration instance named Slack Web API — update the adapter_id value in each workflow task if yours is named differently |