GET/api/public/v1/agent/console

agent.console_get

agent.console_get — Profile-scoped sanitized leases and operation states, without outcomes or secrets.

Capability: session.readMCP tool: agent_console_get

Parameters

Name	Type	Required	Description
`profile_id`query	string (uuid)	No

Examples

curl "https://browlix.com/api/public/v1/agent/console" \
  -H "Authorization: Bearer $BROWLIX_API_KEY"

Response

200 with { data, correlation_id }.

Field	Type	Always present	Description
data	object	Yes
data.profiles	array<object>	Yes
data.profiles[].profile_id	string (uuid)	Yes
data.profiles[].name	string	Yes
data.profiles[].lease	object \| null	Yes
data.profiles[].lease.profile_id	string (uuid)	Yes
data.profiles[].lease.session_id	string (uuid) \| null	Yes
data.profiles[].lease.epoch	integer	Yes	(min 0, max 9007199254740991)
data.profiles[].lease.holder_kind	string	Yes
data.profiles[].lease.expires_at	string	Yes
data.profiles[].lease.control_mode	"quiet" \| "compat"	Yes
data.profiles[].lease.handoff_state	"AGENT_CONTROLLED" \| "PAUSING" \| "HUMAN_CONTROLLED" \| "RESUME_PENDING"	Yes
data.profiles[].lease.released_at	string \| null	Yes
data.profiles[].operations	array<object>	Yes
data.profiles[].operations[].id	string (uuid)	Yes
data.profiles[].operations[].op	string	Yes
data.profiles[].operations[].state	"pending" \| "succeeded" \| "failed" \| "unknown"	Yes
data.profiles[].operations[].created_at	string	Yes
data.profiles[].operations[].state_version	integer	Yes	(min 0, max 9007199254740991)
data.profiles[].sessions	array<object>	Yes
data.profiles[].sessions[].id	string (uuid)	Yes
data.profiles[].sessions[].lifecycle	string	Yes
data.profiles[].sessions[].created_at	string	Yes
data.profiles[].sessions[].budget	object \| null	Yes
data.profiles[].preflight	object	Yes
data.profiles[].preflight.measured	boolean	Yes
data.profiles[].preflight.ready	boolean \| null	Yes
correlation_id	string (uuid)	Yes
ok	true	No
operation_id	string \| null	No
state_version	integer	No	(min 0)
retryable	false	No
next	null	No

New fields can appear at any time; ignore the ones you do not know.

Errors

Code	HTTP	Retryable
UNAUTHENTICATED	401	No
FORBIDDEN	403	No
RATE_LIMITED	429	Yes
VALIDATION_FAILED	422	No
DEPENDENCY_UNAVAILABLE	503	Yes
UNKNOWN	500	No

Every error code and when to retry

All operations

discovery
- GETget
openapi
- GETget
workspace
- GETget
- PATCHrename
members
- GETlist
invites
- POSTcreate
audit
- GETlist
receipts
- GETget
profiles
- GETlist
- GETget
- POSTcreate
- PATCHupdate
- POSTaccept_egress_change
- POSTtrash
- POSTrestore
- GETsync.get
- POSTsync.restore
- GETcleanup.preflight
- POSTcleanup.run
- GETcleanup.list
- POSTsync.release
- GETextensions
- GETbookmarks
- GETeffective_fingerprint
- GETnoise_status
- POSTnoise_upgrade
- GETdrift_list
- GETconsistency_report
- POSTcreate_from_context
- POSTdrift_accept
- GETexit_diagnostics
groups
- GETlist
- POSTcreate
- PATCHupdate
- POSTdelete
tags
- GETlist
- POSTcreate
- PATCHupdate
- POSTdelete
preference_templates
- GETlist
- GETget
- POSTcreate
- POSTpublish
- PATCHupdate
- POSTupgrade_profiles
proxies
- GETlist
- GETget
- POSTcreate
- PATCHupdate
- POSTdelete
devices
- GETlist
- POSTstorage.move
- POSTadspower_api.set
- POSTdraining.set
- GETcapabilities
sessions
- GETlist
- GETget
- POSTstart
- POSTstop
- POSTattach
- POSTrecover
- POSTacquire
- POSTrenew
- POSTdetach
- GETevents
- POSTensure
- POSTagent_attach
- POSTlease_release
- POSThandoff_request
- POSThandoff_resume
bindings
- GETlist
- POSTcreate
- PATCHupdate
- POSTdelete
sync
- GEToverview
- PATCHretention.set
shares
- GETpreview
- POSTcreate
- GETlist
- POSTrevoke
- POSTretry
- GETinbox
- POSTaccept
- POSTdecline
extensions
- GETlist
- GETget
- POSTupload
- POSTadd
- POSTreview
- POSTset_active
- POSTset_state
- POSTassign
- POSTunassign
- POSTdelete
bookmarks
- POSTimport
- GETlist
- GETget
- POSTdelete
- POSTpreview
- POSTapply
- POSTcancel
data_keys
- POSTrotate
usage
- GETget
webhooks
- GETlist
- POSTcreate
- PATCHupdate
- POSTrotate_secret
- POSTdelete
- POSTtest
- GETdeliveries
- POSTredeliver
flows
- GETlist
- GETget
- POSTrun
runs
- GETlist
- GETget
- POSTstop
- POSTpause
- POSTretry
run_targets
- GETget
- POSTresolve
tasks
- GETlist
- POSTrun
schedules
- GETlist
- POSTset_state
approvals
- GETlist
- POSTdecide
feedback
- POSTsubmit
- GETlist
- GETget
- POSTcomment
operations
- GETget
workers
- POSTprovision_run
- GEThealth_get
- GETprovision_preview
- POSTcore_channel_set
agent
- GETconsole_get
- POSTpreflight
personas
- GETcontexts_list
core
- GETfreshness_get

Using an AI agent?

Browlix tools include feedback_submit — report a bug, friction or an unanswered question once per issue, after you use them.

How feedback works