Lists all of the users in the organization.

GET /organization/users
Api key auth

Query parameters

  • limit integer

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

    Default value is 20.

  • after string

    A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

  • emails array[string]

    Filter by the email address of users.

Responses

  • 200 application/json

    Users listed successfully.

    Hide response attributes Show response attributes object
    • object string Required

      Value is list.

    • data array[object] Required

      Represents an individual user within an organization.

      Hide data attributes Show data attributes object
      • object string Required

        The object type, which is always organization.user

        Value is organization.user.

      • id string Required

        The identifier, which can be referenced in API endpoints

      • name string Required

        The name of the user

      • email string Required

        The email address of the user

      • role string Required

        owner or reader

        Values are owner or reader.

      • added_at integer Required

        The Unix timestamp (in seconds) of when the user was added.

    • first_id string Required
    • last_id string Required
    • has_more boolean Required
GET /organization/users 
curl \
 --request GET 'https://api.openai.com/v1/organization/users' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "object": "list",
  "data": [
    {
      "object": "organization.user",
      "id": "string",
      "name": "string",
      "email": "string",
      "role": "owner",
      "added_at": 42
    }
  ],
  "first_id": "string",
  "last_id": "string",
  "has_more": true
}