Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColorgreen
borderWidth1
titleBGColor#ddffcc
borderStylesolid
titleDefinition

App API can perform many app-level functions.interact with the app design of the current app.

Note

This API The options here is based on the current app context.

Image Modified


NameDescription
1

Anchor
Add environment variable

Add environment variable
Add environment variable

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Add

Adds

a new environment variable to the current app.

Name

Description
Create new versionCreates a new app version.
URL/app/environment
HTTP MethodPOST
Body Parameters
ParameterDescription
idEnvironment variable ID.
valueEnvironment variable value.
remarksDescription of environment variable.
Sample Response
Code Block
languagejs
{
  "value": "I exist via API.",
  "remarks": "This is an environment variable created with API Builder.",
  "id": "apiEnvVar"
}
2

Anchor
Create new version
Create new version
Create new version

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Create a new app version based on the specified version of the current app.

Name

Description
URL/app/new/{version}
HTTP MethodPOST
Path Parameters
ParameterDescription
version

Version of current app to base on. Expects an integer value.

Use "0" value to use the latest app version.

Sample Response
Code Block
languagejs
{
  "published": false,
  "description": null,
  "meta": null,
  "id": "expenseclaim",
  "version": 2,
  "name": "Expenses Claim",
  "dateCreated": "Aug 26, 2019 4:37:19 PM",
  "dateModified": "Aug 26, 2019 4:37:22 PM"
}
3

Anchor
Delete environment variable
Delete environment variable
Delete environment variable

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Delete

Delete environment variableRemoves

the specified environment variable in the current app.

Name

Description
URL/app/environment/{id}
HTTP MethodDELETE
Path Parameters
ParameterDescription
idID of environment variable to remove. Expects a string.
Sample Response
Code Block
languagejs
{
  "date": "Mon Aug 26 16:57:53 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
4

Anchor
Delete version
Delete version
Delete version

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Delete

Delete versionRemoves

the specified app version

in context

of the current app.

Name

Description
URL/app/delete/{version}
HTTP MethodDELETE
Path Parameters
ParameterDescription
versionVersion of current app to remove. Expects an integer value.
Sample Response
Code Block
languagejs
{
  "date": "Mon Aug 26 17:02:35 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
5

Anchor
Deploy XPDL
Deploy XPDL
Deploy XPDL

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Deploy a XPDL file as

Deploys

a new/updated process design to the current app.

Name

Description
URL/app/deploy/xpdl
HTTP MethodPOST
Body Parameters
ParameterDescription
FileExpects a XPDL file.
Sample Response
Code Block
languagejs
{
  "date": "Mon Aug 26 18:17:30 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
6

Anchor
Download XPDL
Download XPDL
Download XPDL

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Download the

specified

process definition of all process(es) as

a XPDL file into the current machine.

XPDL file.

Name

Description
URL/app/xpdl
HTTP MethodGET
Parameters

-

Sample Response

Definition of all process(es) as XPDL.

7

Anchor
Download addon builder definition
Download addon builder definition
Download addon builder definition

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Download the specified addon builder page JSON definition.

Name

Description
URL/app/{builder}/definition/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
builderBuilder's ID. (e.g: "api" for API Builder)
idBuilder page's ID.
Sample Response

JSON definition of the builder's page.

8

Anchor
Download datalist definition
Download datalist definition
Download datalist definition

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Download the specified datalist JSON definition.

Name

Description
URL/app/datalist/definition/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idDatalist ID.
Sample Response

JSON definition of the Datalist.

9

Anchor
Download form definition
Download form definition
Download form definition

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Download the specified form JSON definition.

Name

Description
URL/app/form/definition/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idForm ID.
Sample Response

JSON definition of the Form.

10

Anchor
Download userview definition
Download userview definition
Download userview definition

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Download the specified userview JSON definition.

Name

Description
URL/app/userview/definition/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idUserview ID.
Sample Response

JSON definition of the Userview.

11

Anchor
Find environment variable
Find environment variable
Find environment variable

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Get values of all environment variable(s) in the current app by default.

Able to filter or sort the returned results via parameters.

Name

Description
URL/app/environment/find
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterEnvironment variable ID.
sort

Environment variable column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "value": "Expenses Claim",
    "remarks": null,
    "id": "AppName"
  },
  {
    "value": "4",
    "remarks": null,
    "id": "counter"
  },
  {
    "value": "8",
    "remarks": "string",
    "id": "string"
  }
]
12

Anchor
Get environment variable by ID
Get environment variable by ID
Get environment variable by ID

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Get values of an environment variable by its specified ID.

Name

Description
URL/app/environment/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idEnvironment variable ID.
Sample Response
Code Block
languagejs
{
  "value": "Expenses Claim",
  "remarks": null,
  "id": "AppName"
}
13

Anchor
Increase environment variable counter value
Increase environment variable counter value
Increase environment variable counter value

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Increments the specified environment variable counter value.

Name

Description
URL/app/environment/increaseCounter
HTTP MethodPUT
Query String Parameters
ParameterDescription
idEnvironment variable ID with a number value only.
amountAmount to increment environment variable. Increments by 1 by default.
Sample Response
Code Block
languagejs
{
  "value": "6",
  "remarks": null,
  "id": "counter"
}
14

Anchor
List created addon builder element
List created addon builder element
List created addon builder element

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List details of all created addon builder element(s) present in the current app.

Name

Description
URL/app/list/{builder}
HTTP Method

GET

Path Parameters
ParameterDescription
builderBuilder's ID. (e.g: "api" for API Builder)
Query String Parameters
ParameterDescription
nameFilterBuilder page ID.
sort

Builder data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "name": null,
    "type": "api",
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "id": "API-c12135da-a5f6-41c4-ba99-bfaa16bbe636"
  },
  {
    "name": null,
    "type": "api",
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "id": "API-5bc8e093-00cd-455a-a6b0-d94aa92a446f"
  }
]
15

Anchor
List created datalist
List created datalist
List created datalist

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List details of all created datalist(s) present in the current app.

Name

Description
URL/app/list/datalist
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterDatalist ID.
sort

Datalist data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "name": null,
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "id": "ExpensesListAll"
  },
  {
    "name": null,
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "id": "ExpensesApproved"
  },
	.....
]
16

Anchor
List created form
List created form
List created form

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List details of all created form(s) present in the current app.

Name

Description
URL/app/list/form
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterForm ID.
sort

Form data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "name": null,
    "tableName": "j_expense_claim",
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "id": "ExpensesApprovalDetail"
  },
  {
    "name": null,
    "tableName": "j_expense_approval",
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "id": "ExpensesApprovalEntry"
  },
	.....
]
17

Anchor
List created userview
List created userview
List created userview

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List details of all created userview(s) present in the current app.

Name

Description
URL/app/list/userview
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterUserview ID.
sort

Userview data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "name": null,
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "thumbnail": null,
    "id": "home"
  },
  {
    "name": null,
    "description": null,
    "dateCreated": null,
    "dateModified": null,
    "thumbnail": null,
    "id": "dashboard"
  }
]
18

Anchor
List versions
List versions
List versions

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List details of all app version(s) of the current app.

Name

Description
URL/app/versions
HTTP MethodGET
Query String Parameters
ParameterDescription
sort

App version data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "published": true,
    "description": null,
    "meta": null,
    "id": "expenseclaim",
    "version": 1,
    "name": "Expenses Claim",
    "dateCreated": "Nov 14, 2018 2:20:33 PM",
    "dateModified": "Aug 26, 2019 7:29:43 PM"
  }
]
19

Anchor
Published version
Published version
Published version

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Get details of the currently published app version of the current app.

Name

Description
URL/app/published
HTTP MethodGET
Parameters

-

Sample Response
Code Block
languagejs
{
  "published": true,
  "description": null,
  "meta": null,
  "id": "expenseclaim",
  "version": 1,
  "name": "Expenses Claim",
  "dateCreated": "Nov 14, 2018 2:20:33 PM",
  "dateModified": "Aug 26, 2019 7:29:43 PM"
}
20

Anchor
Retrieve created addon builder element as options
Retrieve created addon builder element as options
Retrieve created addon builder element as options

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List label & value of all addon builder element(s) present in the current app.

Name

Description
URL/app/{builder}/options
HTTP MethodGET
Path Parameters
ParameterDescription
builderBuilder's ID. (e.g: "api" for API Builder)
Query String Parameters
ParameterDescription
nameFilterBuilder page ID.
sort

Builder data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "label": "",
    "value": ""
  },
  {
    "label": "Expense Claim Data",
    "value": "API-c12135da-a5f6-41c4-ba99-bfaa16bbe636"
  },
  {
    "label": "Test API Document KB",
    "value": "API-5bc8e093-00cd-455a-a6b0-d94aa92a446f"
  }
]
21

Anchor
Retrieve created datalist as options
Retrieve created datalist as options
Retrieve created datalist as options

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List label & value of all datalist(s) present in the current app.

Name

Description
URL/app/datalist/options
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterDatalist ID.
sort

Datalist data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "label": "",
    "value": ""
  },
  {
    "label": "Expense All",
    "value": "ExpensesListAll"
  },
  {
    "label": "Expense Approved",
    "value": "ExpensesApproved"
  },
	.....
]
22

Anchor
Retrieve created form as options
Retrieve created form as options
Retrieve created form as options

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List label & value of all form(s) present in the current app.

Name

Description
URL/app/form/options
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterForm ID.
sort

Form data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "label": "",
    "value": ""
  },
  {
    "label": "Expense Approval Detail",
    "value": "ExpensesApprovalDetail"
  },
  {
    "label": "Expense Approval Entry",
    "value": "ExpensesApprovalEntry"
  },
	.....
]
23

Anchor
Retrieve created userview as options
Retrieve created userview as options
Retrieve created userview as options

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List label & value of all userview(s) present in the current app.

Name

Description
URL/app/userview/options
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterUserview ID.
sort

Userview data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
Code Block
languagejs
[
  {
    "label": "",
    "value": ""
  },
  {
    "label": " Expenses Claims App",
    "value": "home"
  },
  {
    "label": "Dashboard Template",
    "value": "dashboard"
  }
]
24

Anchor
Retrieve processes as options
Retrieve processes as options
Retrieve processes as options

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

List label & value of all process(es) present in the current app.

Name

Description
URL/app/process/options
HTTP MethodGET
Parameters

-

Sample Response
Code Block
languagejs
[
  {
    "label": "",
    "value": ""
  },
  {
    "label": "Expense Approval Process (process1)",
    "value": "process1"
  },
  {
    "label": "Process 2 TEST (testprocess2)",
    "value": "testprocess2"
  }
]
25

Anchor
Update environment variable
Update environment variable
Update environment variable

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Update the value of an environment variable in the current app.

Name

Description
URL/app/environment
HTTP MethodPUT
Body Parameters
ParameterDescription
idAny existing environment variable ID.
valueEnvironment variable value to overwrite.
remarksDescription of environment variable to overwrite.
Sample Response
Code Block
languagejs
{
  "value": "string",
  "remarks": "string",
  "id": "string"
}