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

# List channels

> List the channels the agent can send and receive on, with the words a client builds its texts about each from, and the most a message on each carries.



## OpenAPI

````yaml /openapi.json get /agents/{id}/channels
openapi: 3.1.0
info:
  title: Artil API
  description: >-
    Give AI agents their own email inbox, SMS number, Telegram bot and Slack
    app.


    Artil adds to the API without notice: new endpoints, fields, values and
    error codes, which clients skip when they do not know them. Fields this
    reference lists stay. An endpoint is marked deprecated here before it is
    removed, and while deprecated it answers with a Deprecation header, plus a
    Sunset header once its removal date is set.
  version: 1.0.0
servers:
  - url: https://app.artil.ai/api
security:
  - token: []
  - oauth:
      - agent
paths:
  /agents/{id}/channels:
    get:
      tags:
        - Channels
      summary: List channels
      description: >-
        List the channels the agent can send and receive on, with the words a
        client builds its texts about each from, and the most a message on each
        carries.
      operationId: listChannels
      parameters:
        - in: path
          name: id
          required: true
          description: The agent's id
          schema:
            type: string
      responses:
        '200':
          description: The channels
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Channel'
        4XX:
          description: The request failed; the error says why
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        5XX:
          description: The request failed; the error says why
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Channel:
      type: object
      properties:
        kind:
          type: string
          description: The channel's kind, which messages and events name
        name:
          type: string
          description: What people and agents call the channel, like Telegram
        labels:
          type: object
          properties:
            address:
              type: string
              description: What an agent has on the channel, like bot
            contact:
              type: string
              description: >-
                How to write someone on the channel, like user id, group id or
                @username
            token:
              description: What connecting an address takes, like bot token from @BotFather
              type: string
          required:
            - address
            - contact
          description: Words a client builds its texts about the channel from
        limits:
          type: object
          properties:
            recipients:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: The most recipients a message goes to
            text:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: The most characters a message holds
            files:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
              description: The most files a message carries
            fileSize:
              description: The most bytes in one file; none without a limit
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
          required:
            - recipients
            - text
            - files
          description: The most a message on the channel carries
      required:
        - kind
        - name
        - labels
        - limits
    Error:
      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
    oauth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://mcp.artil.ai/oauth/authorize
          tokenUrl: https://mcp.artil.ai/oauth/token
          scopes:
            agent: Act as the agent chosen at sign-in

````

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