Skip to main content
PUT
Update the session sidebar layout
The change applies to every agent. card_order and hidden_cards replace the stored lists, so read them with Get layout first and send the full list you want. Entries must be unique. To put a widget between built-in cards, give its app:<mini app id> entry that place in card_order.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
card_order
string[]

The new order, replacing the stored one. Entries are unique built-in card keys and app:<mini app id> entries.

Maximum array length: 500
Required string length: 1 - 200
hidden_cards
string[]

The built-in card keys to hide, replacing the stored list.

Response

Default Response

card_order
string[]
required

Cards and widgets in the order the session sidebar shows them: built-in card keys and app:<mini app id> entries, one per mini-app widget. Empty means the default arrangement.

hidden_cards
string[]
required

Built-in card keys hidden from the sidebar.