Public API v1 → Dashboard Prompts Endpoint

About the /dashboards/{dashboardGuid}/prompts endpoint

The /dashboards/{dashboardGuid}/prompts endpoint will return a list of all prompts and presentation variables in a requested dashboard. If the dashboard does not contain prompts or presentation variables, the endpoint will return a list of the dashboard’s dimension values. This endpoint is accessed with a GET request.

For information about how to get started with Public API v1, refer to References → Public API v1.

Note

Use the HTTPS or HTTP scheme according to your installation.

Header requirements

In the request header you will need to include your access token with a type of Bearer.

For information about how to create an access token, refer to Public API v1 → Create Token Endpoint.

Following is an example of the authorization line required in the request header:

Authorization: "Bearer <Access Token>"

Request URL

Use one of the following URLs to call the /dashboards/{dashboardGuid}/prompts endpoint.

  • https://<cluster_URL>/incorta/api/v1/dashboards/<dashboardGuid>/prompts
  • https://<server address>:<port>/incorta/api/v1/dashboards/<dashboardGuid>/prompts

The dashboardGuid is located in the URL of the desired dashboard. It is required in the /dashboards/{dashboardGuid}/prompts endpoint URL. The following are instructions on where to locate the dashboardGuid:

  • As the user that wants to access the public API of a dashboard, sign into the Incorta Direct Data Platform™.
  • In the navigation bar, select Content.
  • Select the desired dashboard.
  • In your browser URL, locate the dashboardGuid in the URL.

Following is an example of where to locate the dashboardGuid in a dashboard URL:

https://<server address>:<port>/incorta/#/dashboard/<dashboardGuid>

Endpoint request

The /dashboards/{dashboardGuid}/prompts endpoint does not require any request payload. The required information for the endpoint, the access token and dasboardGuid is located in the header and URL path.

Endpoint response

The /dashboards/{dashboardGuid}/prompts endpoint has three possible response codes and payloads.

CodeDescriptionPayload Response
200OKSee Dashboard prompts: 200 Response
404Not Found - dashboard does not exist.{"message": "string"}
500Internal Server Error{"message": "string"}

Endpoint 200 response

{
"prompts": [
{
"dataType": "string",
"field": "string",
"function": "string",
"label": "string",
"operator": "string",
"defaultValues": [
"string"
],
"values": [
"string"
],
"variable": "string"
}
]
}