> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recoupable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Webhook

> Webhook endpoint for the Recoup Content Agent Slack bot. Receives @mention events from Slack and triggers content generation for the mentioned artist. The bot parses the mention text for `<artist_account_id> [template] [batch=N] [lipsync]`, validates the artist, calls POST /api/content/create, and starts a background polling task that reports results back to the Slack thread.

For Slack, also handles `url_verification` challenges during app setup.



## OpenAPI

````yaml api-reference/openapi/content.json POST /api/content-agent/{platform}
openapi: 3.1.0
info:
  title: Recoup API - Content
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/content-agent/{platform}:
    post:
      description: >-
        Webhook endpoint for the Recoup Content Agent Slack bot. Receives
        @mention events from Slack and triggers content generation for the
        mentioned artist. The bot parses the mention text for
        `<artist_account_id> [template] [batch=N] [lipsync]`, validates the
        artist, calls POST /api/content/create, and starts a background polling
        task that reports results back to the Slack thread.


        For Slack, also handles `url_verification` challenges during app setup.
      parameters:
        - name: platform
          in: path
          description: Chat platform identifier. Currently supports `slack`.
          required: true
          schema:
            type: string
            enum:
              - slack
      requestBody:
        description: >-
          Slack Events API payload (app_mention event or url_verification
          challenge)
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Slack Events API envelope — the shape depends on the event type
      responses:
        '200':
          description: Event processed successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
        '404':
          description: Unknown platform

````