List the CLI sessions listening now
LogsGET /developer/cli-sessions
Returns the tenant's live CLI sessions, newest first, with cursor pagination, so the dashboard can show who is listening and to which events. Secrets are never returned here. Requires developer:read.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Returns
200 Live sessions
Show attributes
dataShow child attributes
idSession identifier, starting with cls_.
tenant_idTenant the session listens to.
eventsEvent types the session receives; empty means every type.
created_byUser who opened the session; only they can poll or end it.
created_atWhen the session was opened.
expires_atWhen the session ends unless polled again.
secretThe whsec_ signing secret, present only in the response that opens the session.
has_morenext_cursor
Permissions developer:read · Roles: admin, owner
curl -X GET "$BUSINESS_API/developer/cli-sessions" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/developer/cli-sessions", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/developer/cli-sessions",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/developer/cli-sessions", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "dev_20UrPQc1lwaN5oeD7Q8xFo2l3KG",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"events": [
"event"
],
"created_by": "created by",
"created_at": "2026-11-19T09:30:00Z",
"expires_at": "2026-11-19T09:30:00Z",
"secret": "secret"
}
],
"has_more": true,
"next_cursor": "next cursor"
}