> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Interactions

> Handles Slack interactive components for Human-in-the-Loop (HITL) workflows.

**Supported Actions:**
- `row_approve` - Approve a pending tool call
- `row_reject` - Reject a pending tool call
- `submit_pause` - Submit form data for a paused workflow
- `check_status` - Check an admin approval and resume an approved run

**Setup:** Configure this URL in your [Slack App](https://api.slack.com/apps) under **Interactivity & Shortcuts > Request URL**.

See the [setup guide](/agent-os/interfaces/slack/setup) for step-by-step instructions or the [HITL guide](/agent-os/interfaces/slack/hitl) for approval workflows.




## OpenAPI

````yaml /reference-api/openapi.yaml post /slack/interactions
openapi: 3.1.0
info:
  title: Agno API Reference
  description: The all-in-one, private, secure agent platform that runs in your cloud.
  version: 2.7.4
servers: []
security: []
paths:
  /slack/interactions:
    post:
      tags:
        - Slack
      summary: Slack Interactions
      description: >
        Handles Slack interactive components for Human-in-the-Loop (HITL)
        workflows.


        **Supported Actions:**

        - `row_approve` - Approve a pending tool call

        - `row_reject` - Reject a pending tool call

        - `submit_pause` - Submit form data for a paused workflow

        - `check_status` - Check an admin approval and resume an approved run


        **Setup:** Configure this URL in your [Slack
        App](https://api.slack.com/apps) under **Interactivity & Shortcuts >
        Request URL**.


        See the [setup guide](/agent-os/interfaces/slack/setup) for step-by-step
        instructions or the [HITL guide](/agent-os/interfaces/slack/hitl) for
        approval workflows.
      operationId: slack_interactions_simple_agent
      parameters:
        - name: X-Slack-Request-Timestamp
          in: header
          required: true
          schema:
            type: string
          description: Unix timestamp when Slack sent the request
        - name: X-Slack-Signature
          in: header
          required: true
          schema:
            type: string
          description: HMAC signature for request verification (v0=hash)
        - name: X-Slack-Retry-Num
          in: header
          required: false
          schema:
            type: string
          description: >-
            Retry attempt number. Retried interactions return 200 without
            reprocessing.
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - payload
              properties:
                payload:
                  type: string
                  description: >-
                    URL-encoded JSON interaction payload (Slack sends
                    interactive component data as a single form field)
      responses:
        '200':
          description: Interaction accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SlackEventResponse'
        '400':
          description: Missing Slack headers or malformed interaction payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestResponse'
        '403':
          description: Invalid Slack signature
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenResponse'
        '500':
          description: Slack signing is not configured
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
components:
  schemas:
    SlackEventResponse:
      properties:
        status:
          type: string
          title: Status
          default: ok
      type: object
      title: SlackEventResponse
    BadRequestResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error detail message
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Code
          description: Error code for categorization
      type: object
      required:
        - detail
      title: BadRequestResponse
      example:
        detail: Bad request
        error_code: BAD_REQUEST
    ForbiddenResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error detail message
      type: object
      required:
        - detail
      title: ForbiddenResponse
      example:
        detail: Insufficient permissions
    InternalServerErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error detail message
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Code
          description: Error code for categorization
      type: object
      required:
        - detail
      title: InternalServerErrorResponse
      example:
        detail: Internal server error
        error_code: INTERNAL_SERVER_ERROR

````