Slack

Slack AI API

The AI API from Slack — 3 operation(s) for ai.

GitHub OpenAPI

Operations 3

POST /assistant.threads.setStatus Set Assistant Thread Status #
POST /assistant.threads.setSuggestedPrompts Set Assistant Thread Suggested Prompts #
POST /assistant.threads.setTitle Set Assistant Thread Title #

Documentation

📖
Documentation
https://docs.slack.dev/admins
📖
Documentation
https://docs.slack.dev/reference/methods
📖
Documentation
https://docs.slack.dev/authentication
📖
Documentation
https://docs.slack.dev/surfaces/canvases
📖
Documentation
https://docs.slack.dev/apis/web-api/using-the-conversations-api
📖
Documentation
https://docs.slack.dev/workflows/workflow-steps
📖
Documentation
https://docs.slack.dev/surfaces/lists
📖
Documentation
https://docs.slack.dev/authentication/sign-in-with-slack
📖
Documentation
https://docs.slack.dev/legacy/legacy-rtm-api
📖
Documentation
https://docs.slack.dev/workflows
📖
Documentation
https://docs.slack.dev/apis/web-api
📖
APIReference
https://docs.slack.dev/reference/methods
📖
RateLimits
https://docs.slack.dev/apis/web-api/rate-limits

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/openapi/slack-ai-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/json-schema/slack-message-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/json-schema/slack-channel-schema.json

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/graphql/slack-graphql.md
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/json-ld/slack-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/slack-ai-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

slack-ai-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Slack Assistant AI API
  description: The Slack Assistant API provides the assistant.threads.* Web API methods that let apps building AI-powered assistants manage threaded conversations in Slack. It includes methods to set the status of an assistant thread (e.g., showing a thinking indicator), set suggested prompts for users to choose from, and set the title of an assistant thread. These methods help apps set user expectations during potentially slow AI responses and guide users with contextual prompt suggestions.
  version: 1.0.0
  contact:
    name: Slack Developer Relations
    url: https://docs.slack.dev
servers:
- url: https://slack.com/api
tags:
- name: AI
paths:
  /assistant.threads.setStatus:
    post:
      tags:
      - AI
      summary: Set Assistant Thread Status
      description: Sets the status of a Slack AI assistant thread, for example showing a thinking indicator.
      operationId: postAssistantThreadsSetStatus
      parameters:
      - name: token
        in: header
        description: 'Authentication token. Requires scope: `assistant:write`'
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              required:
              - channel_id
              - thread_ts
              - status
              type: object
              properties:
                channel_id:
                  type: string
                  description: The channel ID of the assistant thread.
                thread_ts:
                  type: string
                  description: The thread timestamp of the assistant thread.
                status:
                  type: string
                  description: The status of the assistant thread (e.g., "is thinking...").
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
              example:
                ok: true
        default:
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  error:
                    type: string
              example:
                ok: false
                error: invalid_auth
      security:
      - slackAuth:
        - assistant:write
  /assistant.threads.setSuggestedPrompts:
    post:
      tags:
      - AI
      summary: Set Assistant Thread Suggested Prompts
      description: Sets the suggested prompts for a Slack AI assistant thread.
      operationId: postAssistantThreadsSetSuggestedPrompts
      parameters:
      - name: token
        in: header
        description: 'Authentication token. Requires scope: `assistant:write`'
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              required:
              - channel_id
              - thread_ts
              - prompts
              type: object
              properties:
                channel_id:
                  type: string
                  description: The channel ID of the assistant thread.
                thread_ts:
                  type: string
                  description: The thread timestamp of the assistant thread.
                prompts:
                  type: string
                  description: JSON-encoded array of suggested prompt objects with title and message fields.
                title:
                  type: string
                  description: An optional title to show above the suggested prompts.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
              example:
                ok: true
        default:
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  error:
                    type: string
              example:
                ok: false
                error: invalid_auth
      security:
      - slackAuth:
        - assistant:write
  /assistant.threads.setTitle:
    post:
      tags:
      - AI
      summary: Set Assistant Thread Title
      description: Sets the title of a Slack AI assistant thread.
      operationId: postAssistantThreadsSetTitle
      parameters:
      - name: token
        in: header
        description: 'Authentication token. Requires scope: `assistant:write`'
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              required:
              - channel_id
              - thread_ts
              - title
              type: object
              properties:
                channel_id:
                  type: string
                  description: The channel ID of the assistant thread.
                thread_ts:
                  type: string
                  description: The thread timestamp of the assistant thread.
                title:
                  type: string
                  description: The title to set for the assistant thread.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
              example:
                ok: true
        default:
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  error:
                    type: string
              example:
                ok: false
                error: invalid_auth
      security:
      - slackAuth:
        - assistant:write
components:
  securitySchemes:
    slackAuth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://slack.com/oauth/v2/authorize
          tokenUrl: https://slack.com/api/oauth.v2.access
          scopes:
            assistant:write: Write access to assistant threads