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

# List who listens

> The connected client, while its event stream checks in or its MCP subscription takes them, and the webhooks that hear messages at the agent's Message URL now. Sending to the Message URL fails while the list is empty.



## OpenAPI

````yaml /openapi.json get /agents/{id}/listeners
openapi: 3.1.0
info:
  title: Artil API
  description: Give AI agents their own email inbox, SMS number and secret storage.
  version: 1.0.0
servers:
  - url: https://app.artil.dev/api
security:
  - token: []
paths:
  /agents/{id}/listeners:
    get:
      tags:
        - Connections
      summary: List who listens
      description: >-
        The connected client, while its event stream checks in or its MCP
        subscription takes them, and the webhooks that hear messages at the
        agent's Message URL now. Sending to the Message URL fails while the list
        is empty.
      operationId: listListeners
      parameters:
        - in: path
          name: id
          required: true
          description: The agent's id
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Who listens
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Listener'
        default:
          $ref: '#/components/responses/Failure'
components:
  schemas:
    Listener:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              const: client
            client:
              type: string
              description: The connected client, like Claude Code
            machine:
              type:
                - string
                - 'null'
          required:
            - kind
            - client
            - machine
        - type: object
          properties:
            kind:
              type: string
              const: webhook
            host:
              type: string
              description: The host of a webhook the agent's members added
          required:
            - kind
            - host
  responses:
    Failure:
      description: The request failed; the error says why
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - invalid_input
                      - unauthorized
                      - forbidden
                      - plan_limit
                      - not_found
                      - conflict
                      - rate_limited
                      - internal
                      - unavailable
                  message:
                    type: string
                required:
                  - code
                  - message
            required:
              - error
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.