SaaSFlow
DevelopersAPIReferencedashboards

Update dashboard

Rename a dashboard or replace its entries. entries replaces the whole list, so read the dashboard first and send it back with your changes; entries you…

Authentication

Checking whether you're signed in…
PATCH
/companies/{companyId}/dashboards/{dashboardId}

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length
dashboardId*string
Length1 <= length

Request Body

application/json
  1. body
name?string
Length1 <= length <= 100
entries?array<|>

Widgets and section headlines in reading order. Leave out x/y/w/h and SaaSFlow lays them out on the 12-column grid: each widget at its default size, left to right, a new row when the next one does not fit, headlines full width. Send all four to place an entry yourself.

Itemsitems <= 60

Response Body

Updated

application/json
  1. response
id*string
name*string
position*number
right*string

The person's access: viewer reads, editor also changes name and layout, owner also deletes.

Value in"viewer""editor""owner"
entries?array<|>
url*string

Where the person opens it in the app.

lastUpdatedTime*string|null
Example Request
curl -X PATCH 'https://api.saasflow.com/companies/string/dashboards/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "name": "string",  "position": 0,  "right": "viewer",  "entries": [    {      "type": "text",      "id": "string",      "text": "string",      "subText": "string",      "x": 0,      "y": 0,      "w": 0,      "h": 0    }  ],  "url": "string",  "lastUpdatedTime": "string"}

Retrieve dashboard

Retrieve one dashboard with its entries: widget ids and section headlines with their grid position (x and w in columns of 12, y and h in rows).

Delete dashboard

Delete a dashboard for everyone it is shared with, including its share links. Only its owners can. The widgets and their data are not affected.