Advanced (alternative) tenant profiling and management

There are a number of tools available for tenant management outside the OrgVue user interface, which can be used for audit and debugging purposes, and also for data export.

To use these tools, log into OrgVue in the normal way. Once your login has been accepted, remove the version number at the end of the URL in your browser's address bar.

Note that your standard OrgVue permissions still apply and access to these tools is not available unless you have the Admin role (with two exceptions - the 'tenants' endpoint which is covered in Specimen 1 below and the 'files' endpoint which is covered in Specimen 7 below, for both of which you only need the 'user' role).

In each of the documented uses below, replace [orgvue] with the appropriate address i.e. ‘’ , depending on the physical environment you are trying to access.

Because in each instance the OrgVue server is being accessed direct, you will need to state the tenant ID of your tenant within the URL, i.e. replace [tenantID] with your Tenant ID. 

The tenant ID may be a non-published anonymous set of alphanumeric symbols, but the first specimen (below) provides a lookup of all tenant IDs and names to which you have access.

1: List Accessible Tenants 
orgvue hosting URL/tenants/tenants 

(Note:  the current OrgVue hosting URLs are available here - You need to replace orgvue hosting URL  in the address above with the OrgVue URL on which your OrgVue tenant is located.)

Lists tenant names and IDs for which you have access.


2: List Tenant Sessions

orgvue hosting URL/[tenantID]/sessions

Lists the last 50 sessions for all users who access the tenant.  The sessions are marked as A (active) or E (expired).

To go further back use this and specify any number you want : -

orgvue hosting URL/[tenantID]/sessions?size=100



If you wish to download more than the default number of sessions (50) to a csv file you will need to use this URL : -

orgvue hosting URL/[tenantID]/sessions?format=csv&size=2000

This will download the most recent 2000 sessions to a csv file.

Further detail on the sessions concerned can be reviewed based on clicking the corresponding down arrow, and further detail still (drilldown) can be identified by appending the relevant Path indicated to the base URL e.g.

orgvue hosting URL/[tenantID]/dataset/9BFAD887-DCDB-9016-BF51-9841A112A4DD

Sessions data can be retrieved as far back as 12 months - any data over a year old is deleted as part of our data retention policy.

However, due to an update made to our data logging tool at the end of January 2020, it is not possible to directly access data prior to that. If you need this data please contact Support.



3: Transactions

orgvue hosting URL/[tenantID]/transactions

orgvue hosting URL/[tenantID]/transactions/50

orgvue hosting URL/[tenantID]/transactions/

List the most relevant transations on the tenant, can be restricted by number or by named user account if required

** Note this page contains advanced functionality of which you should be aware before accessing it, please contact OrgVue Support before accessing this page **


4: Users in a Tenant 

orgvue hosting URL/[tenantID]/users 

For Tenant Admins - lists all individuals with access to the tenant, also showing their role

For non-Tenant Admins - lists all individual's role (s) if they have tenant access


5: Datasets in a Tenant 

orgvue hosting URL/[tenantID]/datasets 

List of datasets and owners with ability to:

  • access audit log - see Events by Key link
  • download csv - see CSV link on left
  • download tsv - see TSV link on left
  • upload/merge data - see Upload link
  • link direct to Transactions - see above

When using the standard OrgVue export function (i.e. Copy) in rare circumstances with very large data structures, Excel may fail to export correctly.  By using the download/export methods here (click on the relevant link), this will be guaranteed to be a true representation of the data, without any TSV parsing issues that might exists between the copy buffer and Excel. 

Note that the property names shown in the headers of the export will be the keys for the data, which are normally hidden in the standard OrgVue user interface.


6: Tasks 

orgvue hosting URL/[tenantID]/tasks 

Shows dataset-associated tasks


7: Files in a Tenant 

orgvue hosting URL/[tenantID]/files

This is a secure encrypted location where the client is able to place files without exposing them to the perils of sending files through by email. This is a useful transfer location when trying to diagnose problems.

This endpoint can be accessed by a profile with either the 'user' or 'admin' role.

Note also that files can be tagged with view/edit role associations as well. 


Have more questions? Submit a request