User Applications

List user applications

Returns list of all applications used by the user.<br/><br/>Filtering is available via the documented query parameters below and by custom application fields.<br/><br/>Multi Currency Support: The field annualCost is returned in the license currency. To retrieve the license currency, currency can be added to fields. Additionally, adding annualCostConverted will return the amount based on the organization's chosen display currency.<br/><br/>Example:<br/><br/>GET /users/12345/apps?fields=id,name,myCustomField&state=discovered&myCustomField=true<br/><br/>The above example returns a list of user applications for the user 12345. Only applications that are in discovered state and myCustomField is true will be returned. Each application object will contain the id, name and myCustomField fields.<br/><br/>

<p><ul><li>Rate limit: 800 requests per minute</li></ul></p>
get/users/{idUser}/apps

Request

  • Base URL
    https://api.toriihq.com/v1.0
  • Auth
    API key in header Authorization

Path parameters

idUserinteger required

Unique user identifier

Query parameters

fieldsstring

List of fields to return for each user application.<br>Allowed fields: id, name, primaryOwner, appOwners, state, category, url, imageUrl, description, tags, score, score60, score90, isCustom, addedBy, creationTime, isHidden, sources, vendor, users, lastUsageTime, isUserRemovedFromApp, annualCost, annualCostConverted, currency and all fields from /apps/fields

isUserRemovedFromAppboolean

true if the user was removed from the application, false otherwise

statestring

Application state

Response

User apps

Example response

{
  "apps": [
    {
      "id": 1000,
      "name": "Salesforce",
      "isUserRemovedFromApp": true,
      "state": "discovered"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.