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

# List team members

> Returns members ordered by join date (oldest first), with names and email addresses when available, plus unaccepted, unexpired invitations ordered newest first. Accepts only a team API key belonging to the team in the path.



## OpenAPI

````yaml /openapi/v1.json get /teams/{teamSlug}/members
openapi: 3.1.0
info:
  title: Felan API
  description: >-
    Team-scoped access to Felan sessions, members, invitations, integrations,
    environments, environment variables, automations, skills, custom subagents,
    and inbound events.
  version: 1.0.0
  contact:
    name: Felan Support
    url: https://felan.ai
servers:
  - url: https://app.felan.ai/api/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Hosts
  - name: Teams
  - name: Integrations
  - name: Environments
  - name: Environment Variables
  - name: Automations
  - name: Skills
  - name: Subagents
  - name: Sessions
  - name: Events
  - name: OpenAPI
paths:
  /teams/{teamSlug}/members:
    get:
      tags:
        - Teams
      summary: List team members
      description: >-
        Returns members ordered by join date (oldest first), with names and
        email addresses when available, plus unaccepted, unexpired invitations
        ordered newest first. Accepts only a team API key belonging to the team
        in the path.
      operationId: listTeamMembers
      parameters:
        - $ref: '#/components/parameters/TeamSlug'
      responses:
        '200':
          description: Team members and pending invitations
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - members
                      - pendingInvitations
                    properties:
                      members:
                        type: array
                        items:
                          $ref: '#/components/schemas/TeamMember'
                      pendingInvitations:
                        type: array
                        items:
                          $ref: '#/components/schemas/TeamInvitation'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    TeamSlug:
      name: teamSlug
      in: path
      required: true
      description: Felan team slug shown in dashboard URLs and Team Settings
      schema:
        type: string
        minLength: 1
  schemas:
    TeamMember:
      type: object
      required:
        - userId
        - role
        - joinedAt
        - name
        - email
      properties:
        userId:
          type: string
          format: uuid
        role:
          type: string
          enum:
            - owner
            - admin
            - member
            - impersonator
        joinedAt:
          type:
            - string
            - 'null'
          format: date-time
        name:
          type:
            - string
            - 'null'
        email:
          type:
            - string
            - 'null'
          format: email
    TeamInvitation:
      type: object
      required:
        - id
        - email
        - role
        - expiresAt
        - createdAt
      properties:
        id:
          type: string
          format: uuid
        email:
          type: string
          format: email
        role:
          type: string
          enum:
            - admin
            - member
        expiresAt:
          type: string
          format: date-time
        createdAt:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              examples:
                - VALIDATION_ERROR
                - UNAUTHORIZED
                - NOT_FOUND
                - SKILL_SOURCE_UNAVAILABLE
                - EXECUTION_DENIED
                - CONFLICT
                - RATE_LIMITED
                - SESSION_START_FAILED
                - SESSION_PUBLISH_FAILED
                - MESSAGE_PUBLISH_FAILED
                - INTERNAL_ERROR
            message:
              type: string
  responses:
    Unauthorized:
      description: Missing or invalid team API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource missing or outside the authenticated team
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Team API key rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: The server could not complete the request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Team API key. Current keys retain the bzy_team_ compatibility prefix.

````

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