---
title: "List the people of the active org with their role"
method: POST
path: "/api/v1/list_members"
tags: ["Org & Connections"]
---

# List the people of the active org with their role

`POST /api/v1/list_members`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/list_members`
- Auth: HTTP bearer

List the people of the active org with their role. Includes profile info (name, avatar). Service accounts (the agents' bot, internal Pymaia accounts) are not members and are not listed.

## Request body

- object

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pymaia/apis/pymaia-api.md) · [All operations](https://skmtc.dev/pymaia/apis/pymaia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pymaia/apis/pymaia-api/revisions/705a6973177b?raw)
