사용자 목록 조회

$client->beta->organization->users->list(?string afterID, ?string beforeID, ?string email, ?int limit, ?list<string> roles): Page<OrganizationUser>

GET/v1/organizations/users

조직의 멤버 목록을 조회합니다.

Parameters

afterID?:optional string

ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.

beforeID?:optional string

ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.

email?:optional string

Filter by user email.

limit?:optional int

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

default20

roles?:optional list<string>

Filter to items whose role equals one of the supplied values. Repeatable; values are OR'ed together.

Accepted values depend on the organization type: Console and API organizations accept user, developer, billing, admin, and claude_code_user; Claude Enterprise organizations accept user, owner, primary_owner, membership_admin, and managed.

Returns

class OrganizationUser { $type = 'user'; $id; $addedAt; /* 3 more */ }

"user" type

Object type.

For Users, this is always "user".

string id

ID of the User.

\Datetime addedAt

RFC 3339 datetime string indicating when the User joined the Organization.

string email

Email of the User.

string name

Name of the User.

BetaOrganizationRole role

Organization role of the User.

사용자 목록 조회

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'my-anthropic-api-key');

$page = $client->beta->organization->users->list(
  afterID: 'after_id',
  beforeID: 'before_id',
  email: 'dev@stainless.com',
  limit: 1,
  roles: ['string'],
);

var_dump($page);

Response 200

{
  "data": [
    {
      "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
      "added_at": "2024-10-30T23:58:27.427722Z",
      "email": "user@emaildomain.com",
      "name": "Jane Doe",
      "role": "admin",
      "type": "user"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
      "added_at": "2024-10-30T23:58:27.427722Z",
      "email": "user@emaildomain.com",
      "name": "Jane Doe",
      "role": "admin",
      "type": "user"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}