UPupguard
userrisk

List a user apps

Changed on

Retrieve a list of apps used by a specific user.

Required API key permissions: UserRisk (select when creating API key in Account Settings)

get/user_risk/users/apps/list

Request

Query parameters

page_sizeinteger

The page size of results to return. If not supplied, default is 100.

page_tokenstring

The page_token from a previous request, use this to get the next page of results.

sort_by'name' | 'first_detected' | 'exposure_level'

The field to sort results by. Default is name.

sort_dir'asc' | 'desc'

The direction to sort results. Default is asc.

idstring required

The ID of the user to retrieve the apps for

Response

The list of app for a user

next_page_tokenstring

The token to be used to retrieve the next page of results. Will not be returned if there are no more results.

Example response

{
  "apps": [
    {
      "approved_replacement_app": {
        "description": "Lorem ipsum dolor sit amet",
        "domain": "atlassian.com",
        "name": "Jira"
      },
      "category": "Project Management",
      "description": "Lorem ipsum dolor sit amet",
      "domain": "app.asana.com",
      "exposure_level": "basic",
      "first_detected": "2023-09-24T15:30:00Z",
      "name": "Asana",
      "sources": [
        "google",
        "browser"
      ],
      "usage_policy_outcome": "tolerate",
      "vendor_id": 123456789,
      "vendor_name": "Asana",
      "vendor_security_rating": 940,
      "vendor_security_rating_trend": 30,
      "vendor_using_ai": true
    }
  ],
  "next_page_token": "acbd18db4cc2f85cedef654fccc4a4d8"
}

Changes

  • d044bf6dc61eRevision changes
    • info

      added the new optional query request parameter sort_by

    • info

      added the new optional query request parameter sort_dir