user.org.find

The user.org.find command is used to find the user's access to an organization.

A user can make this request for any organization they have access to. An organization administrator can make this request for any user within their organization. A SuperOps user can make this request for any user and any organization.

TR50 Request

{
  "1": {
    "command": "user.org.find",
    "params": {
      "userId": "52a1d3db169e1fd03217940d",
      "orgId": "51db169e1fd032179402a1df"
    }
  }
}

Request Parameters

Name

Type

Required

Description

userId

String

 

The object Id of the user. Defaults to the current user.

orgId

String

 

The object Id of the organization. Defaults to the current organization.

TR50 Response

If the command is sent successfully a success message and the user access details are returned. Otherwise, an error and error message are returned.

{
  "1": {
    "success": true,
    "params": {
      "addedBy": "SYSTEM",
      "addedOn": "2013-12-06T08:40:43.885-05:00",
      "orgId": "52a1d3db169e1fd032179408",
      "orgKey": "SYSTEM",
      "isOrgAdmin": false
      "roles": ["52a1d3db169e1fd03217940a", "52a1d3db169e1fd03217941b"],
      "tags": ["tag1", "tag2"]
    }
  }
}

Response Result Parameters

Name

Type

Description

addedBy

String

The creator of the record.

addedOn

String

The timestamp of the record.

orgId

String

The organization object Id.

orgKey

String

The organization key.

isOrgAdmin

Boolean

Whether the user is an organization administrator.

roles

Array

An array of role object Ids.

tags

Array

An array of security tags.