/api/public/v1/sessions/{id}/agent-attachsessions.agent_attach
sessions.agent_attach — Reserve reader or writer agent lease; writers additionally require agent.act in the database. This is not a CDP connection ticket.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
idpath | string (uuid) | Yes | |
idempotency_keybody | string | Yes | (min length 1, max length 163) |
holder_kindbody | "api" | "mcp" | "rpa" | "cdp" | "human" | Yes | |
modebody | "reader" | "writer" | No | Default: `"writer"`. |
epochbody | integer | No | (min 0, max 9007199254740991) |
ttl_secondsbody | integer | No | (min 1, max 900) Default: `300`. |
control_modebody | "quiet" | "compat" | No | Default: `"quiet"`. |
Examples
curl -X POST "https://browlix.com/api/public/v1/sessions/<id>/agent-attach" \
-H "Authorization: Bearer $BROWLIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"idempotency_key":"<idempotency_key>","holder_kind":"api"}'Response
200 with { data, correlation_id }.
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 |
All operations
- 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
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