app.find

The app.find service is used to retrieve an application token.

To find the application, specify the following:

  • The name of the application.

  • The application token.

The application session must have organization administrator privileges.

TR50 Request

// Application name
{
  "put": {
    "command": "app.find",
    "params": {
      "name": "myname"
    }
  }
}
 
// Application token
{
  "put": {
    "command": "app.find",
    "params": {
      "token": "qwertyasdf1234567890zxcvb"
    }
  }
}

Request Parameters

Name

Type

Required

Description

name

String

 

The name.

token

String

 

The token string

TR50 Response

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

{
  "put": {
    "success": true,
    "params": {
      "id": "",
      "name": "myname",
      "desc": "My application description",
      "token": "qwertyasdf1234567890zxcvb",
      "autoRegThingDefId": "",
      "autoRegTags": ["", ""],
      "autoRegSecTags": ["", ""],
      "roles": ["", ""],
      "isSuperAdmin": false,
      "isSuperOps": false,
      "isOrgAdmin": false,
      "license": "",
      "createdBy": "admin@example.com",
      "createdOn": "2014-02-04T14:36:26.783-05:00",
      "updatedBy": "admin@example.com",
      "updatedOn": "2014-03-27T11:06:32.758-04:00",
      "connected": false
    }
  }
}

Response Parameters

Name

Type

Description

id

String

The object id for the application.

name

String

The name.

desc

String

The description.

token

String

The token string.

autoRegThingDefId

String

 

autoRegTags

Array

 

autoRegSecTags

Array

 

roles

Array

The roles granted to the application during execution.

isSuperAdmin

Boolean

If the application can run with SuperAdmin permissions.

isSuperOps

Boolean

If the application can run with SuperOps permissions.

isOrgAdmin

Boolean

If the application can run with Org-Admin permissions.

license

String

 

createdBy

String

The email address of the user who created the thing.

createdOn

String

The date and time that the thing was created.

updatedBy

String

The email address of the user who last updated the thing.

updatedOn

String

The date and time that the thing was updated.