> ## 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 Coding Agent Slack Tags (Admin)

> Returns a list of Slack mentions of the Recoup Coding 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 GitHub pull request URLs opened in response. Also returns aggregate pull request statistics. 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/coding/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/coding/slack:
    get:
      description: >-
        Returns a list of Slack mentions of the Recoup Coding 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 GitHub pull request URLs opened in response. Also
        returns aggregate pull request statistics. 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_pull_requests
                  - tags_with_pull_requests
                  - tags
                properties:
                  status:
                    type: string
                    enum:
                      - success
                    description: Status of the request
                  total:
                    type: integer
                    description: >-
                      Total number of times the Coding Agent was tagged in the
                      requested period
                    example: 134
                  total_pull_requests:
                    type: integer
                    description: >-
                      Total number of pull requests opened by the Coding Agent
                      across all tags in the requested period
                    example: 121
                  tags_with_pull_requests:
                    type: integer
                    description: >-
                      Number of tags that resulted in at least one pull request
                      being opened
                    example: 84
                  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: add dark mode support to the settings page
                        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: dev-team
                        pull_requests:
                          type: array
                          description: >-
                            GitHub pull request URLs opened by the Coding Agent
                            in response to this prompt, parsed from bot replies
                            in the Slack thread
                          items:
                            type: string
                            format: uri
                            example: https://github.com/recoupable/api/pull/42
                          example:
                            - https://github.com/recoupable/api/pull/42
        '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

````