Get operators

x-ms-visibility: "important"

Get a list of operators. Possible values for SigninType: Federated, emailAddress

Query Parameters

page int32 required

Page to be fetched. Default: 1

limit int32 required

Limit (No. of records per page). Max value: 100. Default: 100.

sortKey string

Sort field to be used. Supported values are 'name' and 'email'. Default: 'email'

sortDescending boolean

Set to 'true' to sort descending based on sort key. Default: 'false'

search string

Free text filter for operators based on name or email.

homeSite int32

Operator home site id.

Responses

• 200
• 400
• 401

---

List of operators

application/json

Schema

Example (from schema)

---

Schema

page int32
limit int32
totalRecords int32
hasNextPage boolean
hasPreviousPage boolean
items object[]
Array [
id string
name string
email string
homeSiteId int64 nullable
homeSiteName string
permissions string[]
assignedPermissions string[]
roles object[]
Array [
id int64
name string
permissions int32[]
Possible values: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
]
signInTypes string[]
]

{
  "page": 0,
  "limit": 0,
  "totalRecords": 0,
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "id": "string",
      "name": "string",
      "email": "string",
      "homeSiteId": 0,
      "homeSiteName": "string",
      "permissions": [
        "string"
      ],
      "assignedPermissions": [
        "string"
      ],
      "roles": [
        {
          "id": 0,
          "name": "string",
          "permissions": [
            0
          ]
        }
      ],
      "signInTypes": [
        "string"
      ]
    }
  ]
}

Exception Details

application/json

Schema

Example (from schema)

---

Schema

errorCode string
message string
errorNumber int32
helpLink string

{
  "errorCode": "string",
  "message": "string",
  "errorNumber": 0,
  "helpLink": "string"
}

User not authorised

Loading...