Skip to main content
PUT
Keep your own Metrics tabs (browser session)

Authorizations

ankra_session
string
cookie
required

Browser session. Mutations also require X-Ankra-CSRF.

Path Parameters

application_id
string
required

Body

application/json

The caller's own tabs of an application's Metrics, the whole list in order.

tabs
string[]
required

0 to 12 keys, none twice, each board: for a dashboard of this application the caller can open. An empty list removes the caller's own tabs.

Maximum array length: 12

Response

The own tabs are kept; the answer is the tabs as the caller sees them now

The tabs of an application's Metrics as the caller sees them: Ankra's order, which the page draws, or the order someone arranged for everyone who opens the application, and the caller's own tabs, which nobody else reads.

tabs
object[]
required

The arranged tabs in order, without the dashboards the caller cannot open or that are gone. Empty on Ankra's order.

Maximum array length: 12
ankra_order
boolean
required

True when the page shows Ankra's order: nobody ever arranged the tabs, or the last change went back to Ankra's order.

left_out
integer
required

How many dashboards on the arranged tabs are left out of tabs because the caller cannot open them or they are gone. The stored order keeps them.

Required range: x >= 0
version
integer | null
required

The version of the last change to the tabs: the base_version of the next change. Going back to Ankra's order is a change like any other and counts the version on, so it stays set on Ankra's order after that. Null only when nobody ever changed the tabs.

Required range: x >= 1
updated_by
object | null
required

Who changed the tabs last, by arranging them or by going back to Ankra's order. Null only when nobody ever changed them.

updated_at
string<date-time> | null
required

When the tabs were changed last. Null only when nobody ever changed them.

last
object | null
required

The tab the caller left Metrics on. Null when they have none, or when it is not a tab Metrics shows them now. One of the caller's own tabs is a tab Metrics shows them.

own_tabs
object[]
required

The caller's own tabs in their order: dashboards of the application they keep for themselves, which the page draws after the shared tabs. Only dashboards the caller can open now; one that is also a tab the caller sees in tabs is answered there alone. Another person's own tabs are never answered. Empty when the caller keeps none.

Maximum array length: 12
own_left_out
integer
required

How many of the caller's own tabs are left out of own_tabs because the dashboard is gone, belongs to another application or none, or is no longer open to the caller. Their ids and titles are not answered.

Required range: x >= 0