List pending directory users

GET

/api/admin/tenants/{tenantId}/directory-connectors/pending-users

Code sample: Shell / cURL

curl --request GET \
  --url 'https://auth.example.com/api/admin/tenants/example/directory-connectors/pending-users?status=pending&limit=25' \
  --header 'Authorization: Bearer <token>'

Lists directory identities that verified successfully but are not linked to an Authrim user.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

tenantId

required

string

Query Parameters

status

string

default: pending

Allowed values: pending approved rejected linked

connector_id

string

/^wwcon_[a-zA-Z0-9]{16}$/

limit

integer

default: 25 >= 1 <= 100

Responses

200

Pending directory users for a tenant.

Media type application/json

object

tenantId

required

string

items

required

Array<object>

object

id

required

string

tenant_id

required

string

connector_id

required

string

/^wwcon_[a-zA-Z0-9]{16}$/

directory_subject

required

string

login_identifier

required

string

status

required

string

Allowed values: pending approved rejected linked

directory_facts

required

object

key

additional properties

created_at

required

integer

updated_at

required

integer

decided_at

integer | null

decided_by

string | null

decision_reason

string | null

linked_user_id

string | null

key

additional properties

key

additional properties

Example

{
  "tenantId": "tenant_123",
  "items": [
    {
      "id": "dirpending_123",
      "tenant_id": "tenant_123",
      "connector_id": "wwcon_8K4M2Q9F7D3H6P1X",
      "directory_subject": "base64url-object-guid",
      "login_identifier": "[email protected]",
      "status": "pending",
      "directory_facts": {
        "identity": {
          "subject": "base64url-object-guid",
          "canonical_username": "[email protected]"
        }
      },
      "created_at": 1782260000000,
      "updated_at": 1782260000000,
      "decided_at": null,
      "decided_by": null,
      "decision_reason": null,
      "linked_user_id": null
    }
  ]
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}