GET/api/public/v1/profiles

profiles.list

Profiles visible to the key's owner; filter by state, q, group, tag, os, network; keyset paginated.

Capability: profile.readPaginatedMCP tool: profiles_list

Parameters

Name	Type	Required	Description
`limit`query	integer	No	Page size (max 100) (min 1, max 100) Default: `50`.
`cursor`query	string	No	page.next_cursor from the previous page (max length 400)
`state`query	"active" \| "trashed"	No	Default: `"active"`.
`q`query	string	No	Search name, number, notes (max length 120)
`group`query	"none" \| string (uuid)	No	Group id, or none for ungrouped
`tag`query	string	No	Up to 20 comma-separated tag ids (all must match) (max length 800)
`os`query	"windows" \| "linux"	No
`network`query	"direct" \| "proxy" \| "missing"	No
`sort`query	"number" \| "name" \| "updated_at" \| "created_at" \| "last_opened_at" \| "trashed_at"	No
`dir`query	"asc" \| "desc"	No

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

200 with { data, page, correlation_id }.

Field	Type	Always present	Description
data	array<object>	Yes
data[].id	string (uuid)	Yes
data[].number	integer	Yes	Workspace-wide profile number (min -9007199254740991, max 9007199254740991)
data[].name	string	Yes
data[].state	"active" \| "trashed"	Yes
data[].revision	integer	Yes	Send as expected_revision when you change the profile (min -9007199254740991, max 9007199254740991)
data[].os	"windows" \| "linux"	Yes
data[].kernel	string	Yes
data[].network_mode	"direct" \| "proxy"	Yes
data[].group	object \| null	Yes
data[].group.id	string (uuid)	Yes
data[].group.name	string	Yes
data[].tags	array<object>	Yes
data[].tags[].id	string (uuid)	Yes
data[].tags[].name	string	Yes
data[].tags[].color	string	Yes
data[].proxy	object \| null	Yes
data[].proxy.id	string (uuid)	Yes
data[].proxy.name	string	Yes
data[].proxy.scheme	"http" \| "https" \| "socks5"	Yes
data[].proxy.host	string	Yes
data[].proxy.port	integer	Yes	(min -9007199254740991, max 9007199254740991)
data[].proxy.last_check	object \| null	No
data[].notes	string	Yes
data[].accounts	integer	Yes	How many platform accounts are stored on the profile (never their secrets) (min -9007199254740991, max 9007199254740991)
data[].created_at	string (date-time)	Yes
data[].updated_at	string (date-time)	Yes
data[].last_opened_at	string (date-time) \| null	Yes
data[].trashed_at	string (date-time) \| null	Yes
correlation_id	string (uuid)	Yes
page	object	No
page.limit	integer	No
page.total	integer	No
page.next_cursor	string \| null	No

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

All operations