...
Itential Platform Pricing Explore flexible plans and options for your team
Itential logo

Slack – Studio Project

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.

Table of Contents

Contents

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

Requirements

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

Integration Configuration

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"
  }
}

OpenAPIs

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.json

Actively-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:

  • Messaging: Post, update, delete, and schedule messages; retrieve permalinks; post ephemeral/"me" messages (chat.*)
  • Conversations: Create, list, get info/history/replies/members, invite, kick, join, leave, archive/unarchive, rename, set purpose/topic, open/close, mark read (conversations.*)
  • Users: List, get info, look up by email, list a user's conversations, presence, identity, and profile get/set (users.*)
  • Files: Upload, list, get info, and delete (files.*)
  • Reactions: Add, remove, get, and list emoji reactions (reactions.*)
  • Pins: Add, remove, and list pinned items (pins.*)
  • User Groups: Create, list, update, enable/disable, and manage membership (usergroups.*)
  • Reminders: Add, complete, delete, get info, and list (reminders.*)
  • Team & Auth: Basic team info (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.json

Full, 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.

Studio Projects

Slack Web API Project

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 Structure

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

Dependencies

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

Agentic Infrastructure Operations Start Here

See how Itential connects AI reasoning to governed execution across your entire infrastructure.