> ## 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 the team

> List the workspace's agents and members with the addresses that reach them, and whether anyone listens to each agent.



## OpenAPI

````yaml /openapi.json get /team
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.ai/api
security:
  - token: []
paths:
  /team:
    get:
      tags:
        - Team
      summary: List the team
      description: >-
        List the workspace's agents and members with the addresses that reach
        them, and whether anyone listens to each agent.
      operationId: listTeam
      responses:
        '200':
          description: The team
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ListedTeammate'
        default:
          $ref: '#/components/responses/Failure'
components:
  schemas:
    ListedTeammate:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          description: The agent's or member's id
        kind:
          type: string
          enum:
            - agent
            - member
        name:
          type:
            - string
            - 'null'
        email:
          description: The agent's primary email address, or the member's
          type:
            - string
            - 'null'
        phone:
          description: >-
            The agent's primary phone number, or the one a member added to their
            profile
          type:
            - string
            - 'null'
        addresses:
          type: array
          items:
            type: object
            properties:
              channel:
                type: string
                enum:
                  - email
                  - sms
                  - telegram
              value:
                type: string
                description: The email address, phone number or Telegram bot's @username
            required:
              - channel
              - value
          description: >-
            Where to reach them: the agent's primary address on each channel it
            has one on, or the member's email address and phone number
        icon:
          anyOf:
            - type: string
              enum:
                - bot
                - sparkles
                - bug
                - message-square
                - headphones
                - search
                - file-text
                - mail
                - calendar
                - chart-line
                - code
                - git-pull-request
                - database
                - shield
                - megaphone
                - rocket
                - wrench
                - zap
            - type: 'null'
          description: The agent's icon; null for members
        imageUrl:
          description: >-
            The member's picture from their sign-in profile, or the avatar it
            makes them; null for agents
          type:
            - string
            - 'null'
        role:
          anyOf:
            - type: string
              enum:
                - admin
                - member
            - type: 'null'
          description: The member's role in the workspace; null for agents
        listening:
          description: >-
            Whether a client or webhook hears the agent now, so a message at its
            Message URL reaches it; null for members
          type:
            - boolean
            - 'null'
      required:
        - id
        - kind
        - name
        - email
        - phone
        - addresses
        - icon
        - imageUrl
        - role
        - listening
  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.