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

# List Content Agent Slack Tags (Admin)

> Returns a list of Slack mentions of the Recoup Content Agent bot, pulled directly from the Slack API as the source of truth. Each entry includes the tagger's information, the prompt they sent, the timestamp, the channel, and any video link responses. Also returns aggregate video statistics for measuring tag-to-video conversion. Supports optional time-period filtering. Requires the authenticated account to be a Recoup admin. Authentication via x-api-key or Authorization Bearer token.



## OpenAPI

````yaml api-reference/openapi/accounts.json GET /api/admins/content/slack
openapi: 3.1.0
info:
  title: Recoup API - Accounts
  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/admins/content/slack:
    get:
      description: >-
        Returns a list of Slack mentions of the Recoup Content Agent bot, pulled
        directly from the Slack API as the source of truth. Each entry includes
        the tagger's information, the prompt they sent, the timestamp, the
        channel, and any video link responses. Also returns aggregate video
        statistics for measuring tag-to-video conversion. Supports optional
        time-period filtering. Requires the authenticated account to be a Recoup
        admin. Authentication via x-api-key or Authorization Bearer token.
      parameters:
        - name: period
          in: query
          description: >-
            Time period to filter tags. One of: all (no date filter), daily
            (last 24 hours), weekly (last 7 days), monthly (last 30 days).
            Defaults to all.
          required: false
          schema:
            type: string
            enum:
              - all
              - daily
              - weekly
              - monthly
            default: all
      responses:
        '200':
          description: Slack tag analytics retrieved successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - total
                  - total_videos
                  - tags_with_videos
                  - tags
                properties:
                  status:
                    type: string
                    enum:
                      - success
                    description: Status of the request
                  total:
                    type: integer
                    description: >-
                      Total number of times the Content Agent was tagged in the
                      requested period
                    example: 18
                  total_videos:
                    type: integer
                    description: >-
                      Total number of videos generated by the Content Agent
                      across all tags in the requested period
                    example: 12
                  tags_with_videos:
                    type: integer
                    description: >-
                      Number of tags that resulted in at least one video being
                      generated
                    example: 10
                  tags:
                    type: array
                    description: List of Slack tag events
                    items:
                      type: object
                      required:
                        - user_id
                        - user_name
                        - prompt
                        - timestamp
                        - channel_id
                        - channel_name
                      properties:
                        user_id:
                          type: string
                          description: Slack ID of the person who tagged the agent
                          example: U012AB3CD
                        user_name:
                          type: string
                          description: Display name of the person who tagged the agent
                          example: Jane Smith
                        user_avatar:
                          type:
                            - string
                            - 'null'
                          description: URL of the Slack avatar
                          example: https://avatars.slack-edge.com/...
                        prompt:
                          type: string
                          description: The text of the message sent to the agent
                          example: create a highlight reel for the new single release
                        timestamp:
                          type: string
                          format: date-time
                          description: ISO 8601 timestamp of the tag event
                          example: '2024-01-15T10:30:00.000Z'
                        channel_id:
                          type: string
                          description: Slack channel ID where the tag occurred
                          example: C012AB3CD
                        channel_name:
                          type: string
                          description: Human-readable name of the Slack channel
                          example: content-team
                        video_links:
                          type: array
                          description: >-
                            Video URLs generated by the Content Agent in
                            response to this prompt, parsed from bot replies in
                            the Slack thread
                          items:
                            type: string
                            format: uri
                            example: https://recoupable.com/v/abc123
                          example:
                            - https://recoupable.com/v/abc123
        '401':
          description: Unauthorized - missing or invalid credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
        '403':
          description: Forbidden - authenticated account is not a Recoup admin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    AccountErrorResponse:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        message:
          type: string
          description: Error message describing what went wrong
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).
    bearerAuth:
      type: http
      scheme: bearer

````