Versions Compared

Old Version 1

changes.mady.by.user Patrice Neff

Saved on

compared with

New Version Current

changes.mady.by.user Patrice Neff

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt

Dashboards are used in projects to visualize the project data.

Methods

Table of Contents
outlinetrue
excludeMethods

List Dashboards

GET https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/dashboards

...

Parameters:
  • tenant – User tenant.
  • project_id – Project identifier.
Headers:See Common Headers.
Status Codes:
  • 200 – Array of dashboards is returned.

See also Common Status Codes.

Returns:

Array of dashboards.

Code Block
js
js
[{
    "search": {
        "query": "Squirro"
    },
    "title": "Squirro",
    "widgets": [{
        "title": "Results",
        "col": 1,
        "row": 1,
        "size_x": 8,
        "size_y": 6,
        "type": "Search",
        "id": 1
    }],
    "type": "result",
    "id": "PSUHQNx8Tie81tfN5d1Nxg",
    "column_count": 16,
    "row_height": 55
}]

Create Dashboard

POST https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/dashboards

Parameters:
  • tenant – User tenant.
  • project_id – Project identifier.
JSON Data:

Data is passed in as a JSON object.

Valid object keys:

  • title – Title of this dashboard, shown to the user (max. 256 characters).
  • widgets – List of widgets on this dashboard. Each widget is a JSON dictionary.
  • search – Search query which is used by default on the dashboard.
  • type – Dashboard type. The valid values are dashboard and result. The latter is used for the Chart result view.
  • column_count – How many columns are in the dashboard grid. This should generally not be set.
  • row_height – How many pixels an individual row takes in the dashboard grid. This should generally not be set.
Headers:See Common Headers.
Status Codes:
  • 201 – Dashboard created.

See also Common Status Codes.

Returns:

Created dashboard

Code Block
js
js
{
    "search": {
        "query": "Squirro"
    },
    "title": "Squirro",
    "widgets": [{
        "title": "Results",
        "col": 1,
        "row": 1,
        "size_x": 8,
        "size_y": 6,
        "type": "Search",
        "id": 1
    }],
    "type": "result",
    "id": "PSUHQNx8Tie81tfN5d1Nxg",
    "column_count": 16,
    "row_height": 55
}

Get Dashboard

GET https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/dashboards/(id: dashboard_id)

...

Update Dashboard

PUT https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/dashboards/(id: dashboard_id)

...

Delete Dashboard

DELETE https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/dashboards/(id: dashboard_id)

...

Move Dashboard

POST https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/dashboards/(id: dashboard_id)/move

...