/api/public/v1/bindingsbindings.list
App account bindings (app_id + external_account_id → profile) with each profile's live session and who holds it (holder_kind person, automation or app); filter by app_id, profile_id or external_account_id; keyset paginated.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limitquery | integer | No | Page size (max 100) (min 1, max 100) Default: `50`. |
cursorquery | string | No | page.next_cursor from the previous page (max length 400) |
app_idquery | string | No | Your app's id, e.g. fb-poster |
profile_idquery | string (uuid) | No | |
external_account_idquery | string | No | The account's id inside your app (no secrets) (min length 1, max length 200) |
Examples
curl "https://browlix.com/api/public/v1/bindings" \
-H "Authorization: Bearer $BROWLIX_API_KEY"Response
200 with { data, page, correlation_id }.
| Field | Type | Always present | Description |
|---|---|---|---|
| data | array<object> | Yes | |
| data[].id | string (uuid) | Yes | |
| data[].app_id | string | Yes | |
| data[].external_account_id | string | Yes | |
| data[].label | string | null | Yes | |
| data[].profile_id | string (uuid) | Yes | |
| data[].profile | object | null | Yes | |
| data[].profile.id | string (uuid) | Yes | |
| data[].profile.os | "windows" | "linux" | Yes | |
| data[].profile.name | string | Yes | |
| data[].profile.state | string | Yes | |
| data[].profile.number | integer | Yes | (min -9007199254740991, max 9007199254740991) |
| data[].metadata | object | Yes | |
| data[].revision | integer | Yes | (min -9007199254740991, max 9007199254740991) |
| data[].created_at | string (date-time) | Yes | |
| data[].updated_at | string (date-time) | Yes | |
| data[].session | object | null | Yes | |
| correlation_id | string (uuid) | Yes | |
| apps | array<object> | No | |
| apps[].app_id | string | Yes | |
| apps[].count | integer | Yes | (min -9007199254740991, max 9007199254740991) |
| page | object | No | |
| page.limit | integer | No | |
| page.total | integer | No | |
| page.next_cursor | string | null | No |
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 |