/api/public/v1/sessions/{id}/attachsessions.attach
Short-lived attach ticket for the session's loopback CDP broker (client must run on that machine).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
idpath | string (uuid) | Yes | Session id |
ttl_secondsbody | integer | No | (min 30, max 900) Default: `300`. |
Examples
curl -X POST "https://browlix.com/api/public/v1/sessions/<id>/attach" \
-H "Authorization: Bearer $BROWLIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'Response
201 with { data, correlation_id }.
| Field | Type | Always present | Description |
|---|---|---|---|
| data | object | Yes | |
| data.ticket | string | Yes | Send as Authorization: Bearer <ticket> to the endpoint |
| data.ticket_id | string (uuid) | Yes | |
| data.session_id | string (uuid) | Yes | |
| data.device_id | string (uuid) | Yes | |
| data.fence | integer | Yes | (min -9007199254740991, max 9007199254740991) |
| data.scope | "cdp.full" | "cdp.observe" | "view.page" | "control.page" | "sync.target" | Yes | |
| data.endpoint | string | Yes | Loopback CDP broker on the machine running the browser |
| data.header | string | Yes | |
| data.expires_at | string (date-time) | Yes | |
| correlation_id | string (uuid) | Yes |
Errors
| Code | HTTP | Retryable |
|---|---|---|
| UNAUTHENTICATED | 401 | No |
| FORBIDDEN | 403 | No |
| RATE_LIMITED | 429 | Yes |
| VALIDATION_FAILED | 422 | No |
| NOT_FOUND | 404 | No |
| DEPENDENCY_UNAVAILABLE | 503 | Yes |
| UNKNOWN | 500 | No |