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

# Get configured users

> List all teammates in your Operata account — their roles, emails, and the groups they belong to — so you can audit access or map Operata user IDs to your own identity store.

Returns every teammate configured in the Operata account, with each user's role and the groups they belong to. Use it to audit who has access or to map Operata user IDs to your own identity store.

## Endpoint

```http theme={null}
GET https://api.operata.io/v2/admin/users
```

## Parameters

This endpoint takes no parameters. Credentials on the request determine the Operata account scope.

## Response

`200 OK` with the configured users for the account.

```json theme={null}
[
  {
    "id": 714,
    "name": "Andy Admin",
    "email": "admin@example.com",
    "role": "Group Admin",
    "groups": [
      {
        "id": "a28453f9-abab-cdcd-efef-84d9e67ac297",
        "name": "Operata Demo",
        "ccp": "https://operata-prod.awsapps.com/connect/ccp-v2"
      }
    ]
  }
]
```

| Field           | Type          | Description                                                                                                                      |
| --------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | integer       | Stable internal user ID.                                                                                                         |
| `name`          | string        | Display name as configured in the Operata console.                                                                               |
| `email`         | string        | The user's login email.                                                                                                          |
| `role`          | string        | The user's role. Today: `Group Admin` or `User`. Treat as an opaque string — additional roles may appear without a version bump. |
| `groups`        | array         | Each Operata account the user belongs to, with the CCP URL for that group.                                                       |
| `groups[].id`   | string (UUID) | The Operata Group ID for that account. Used as the username for HTTP Basic on API requests.                                      |
| `groups[].name` | string        | Human-readable group name.                                                                                                       |
| `groups[].ccp`  | string (URL)  | The Amazon Connect CCP URL associated with the group.                                                                            |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
    "https://api.operata.io/v2/admin/users"
  ```

  ```javascript Node.js theme={null}
  const groupId = process.env.OPERATA_GROUP_ID;
  const apiToken = process.env.OPERATA_API_TOKEN;
  const auth = Buffer.from(`${groupId}:${apiToken}`).toString("base64");

  const response = await fetch("https://api.operata.io/v2/admin/users", {
    headers: { Authorization: `Basic ${auth}` },
  });
  const users = await response.json();
  ```

  ```python Python theme={null}
  import os, requests

  response = requests.get(
      "https://api.operata.io/v2/admin/users",
      auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
  )
  response.raise_for_status()
  users = response.json()
  ```
</CodeGroup>

## Errors

| Status | Code        | When                                                               | Recover                                                                                           |
| ------ | ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| 403    | `forbidden` | The token belongs to a user without the Admin role.                | Generate a token from an account with the **Group Admin** role under **Settings → Config → API**. |
| 404    | `not_found` | No users exist in the Operata account this token authenticates to. | Confirm you sent the right `Operata Group ID` in the Basic credentials.                           |

See [Errors](/docs/api-errors) for shared codes such as `401 unauthorized`, `429 rate_limited`, and the `5xx` family.

## Related

* [Authentication](/docs/api-authentication) — how the `Operata Group ID` returned in `groups[].id` authenticates API requests.
* [Versioning](/docs/api-versioning) — this endpoint lives under `/v2`; the versioning policy explains how `/v1` and `/v2` coexist.
* [Errors](/docs/api-errors) — shared status codes and recovery patterns.


## OpenAPI

````yaml GET /v2/admin/users
openapi: 3.0.3
info:
  title: operata-api
  version: '1'
servers:
  - url: https://api.operata.io/
security:
  - sec0: []
paths:
  /v2/admin/users:
    get:
      summary: Get Configured Users
      description: >-
        Returns details of the **Admin **and **User** level Teammates (users)
        configured in the Operata platform.
      operationId: get-configured-users
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: |2-
                     {
                     "id": 714,
                            "name": "Andy Admin",
                            "groups": [
                                {
                                    "id": "a28453f9-c9d3-xxxx-xxxx-84d9e67ac297",
                                    "name": "Operata Demo",
                                    "ccp": "https://operata-prod.awsapps.com/connect/ccp-v2"
                                }
                            ],
                            "email": "andy+admin@operata.com",
                            "role": "Group Admin"
                        }
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    example: 714
                    default: 0
                  name:
                    type: string
                    example: Andy Admin
                  groups:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: a28453f9-c9d3-xxxx-xxxx-84d9e67ac297
                        name:
                          type: string
                          example: Operata Demo
                        ccp:
                          type: string
                          example: https://operata-prod.awsapps.com/connect/ccp-v2
                  email:
                    type: string
                    example: andy+admin@operata.com
                  role:
                    type: string
                    example: Group Admin
        '401':
          description: '401'
          content:
            text/plain:
              examples:
                Result:
                  value: "<html>\n\n<head>\n\t<title>401 Authorization Required</title>\n</head>\n\n<body>\n\t<center>\n\t\t<h1>401 Authorization Required</h1>\n\t</center>\n\t<hr>\n\t<center>nginx/1.19.2</center>\n</body>\n\n</html>"
        '404':
          description: '404'
          content:
            text/plain:
              examples:
                Result:
                  value: Call Summary record could not be found
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic

````