Skip to main content
FuseFuse
IntegrationsOktaActions

List Okta users

List users in the connected Okta org with curated filters.

Agent markdown

users.list · Okta · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • okta.users.read

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
page_sizeintegerNominimum 1; maximum 200
cursorstringNominLength 1; maxLength 512
statusstringNominLength 1; maxLength 64
qstringNominLength 1; maxLength 256

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
usersarray<object>YesmaxItems 200
users[]objectYesadditionalProperties false
users[].idstringYesminLength 1; maxLength 128
users[].statusstringYesminLength 1; maxLength 64
users[].transitioning_to_statusstringNominLength 1; maxLength 64
users[].created_atstringNominLength 1; maxLength 64
users[].activated_atstringNominLength 1; maxLength 64
users[].last_login_atstringNominLength 1; maxLength 64
users[].profileobjectYesadditionalProperties false
users[].profile.loginstringYesminLength 1; maxLength 320
users[].profile.emailstringYesminLength 3; maxLength 320
users[].profile.first_namestringYesminLength 1; maxLength 256
users[].profile.last_namestringYesminLength 1; maxLength 256
users[].profile.display_namestringNominLength 1; maxLength 256
users[].profile.titlestringNomaxLength 256
users[].profile.departmentstringNomaxLength 256
users[].profile.manager_idstringNominLength 1; maxLength 128
users[].profile.employee_numberstringNomaxLength 128
users[].profile.organizationstringNomaxLength 256
users[].profile.cost_centerstringNomaxLength 128
next_cursorstringNominLength 1; maxLength 512

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "status": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "users": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "status": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "transitioning_to_status": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "created_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "activated_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "last_login_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "profile": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "login": {
                "type": "string",
                "minLength": 1,
                "maxLength": 320
              },
              "email": {
                "type": "string",
                "minLength": 3,
                "maxLength": 320
              },
              "first_name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256
              },
              "last_name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256
              },
              "display_name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256
              },
              "title": {
                "type": "string",
                "maxLength": 256
              },
              "department": {
                "type": "string",
                "maxLength": 256
              },
              "manager_id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "employee_number": {
                "type": "string",
                "maxLength": 128
              },
              "organization": {
                "type": "string",
                "maxLength": 256
              },
              "cost_center": {
                "type": "string",
                "maxLength": 128
              }
            },
            "required": [
              "login",
              "email",
              "first_name",
              "last_name"
            ]
          }
        },
        "required": [
          "id",
          "status",
          "profile"
        ]
      },
      "maxItems": 200
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    }
  },
  "required": [
    "users"
  ]
}