Skip to main content
POST/api/public/v1/sessions/ensure

sessions.ensure

sessions.ensure — Ensure a profile session; retry with the same idempotency_key, never a new key after an uncertain outcome.

Capability: agent.sessionMCP tool: sessions_ensure
View as Markdown

Parameters

NameTypeRequiredDescription
idempotency_keybodystringYes(min length 1, max length 163)
profile_idbodystring (uuid)Yes
device_idbodystring (uuid)Yes
epochbodyintegerNo(min 0, max 9007199254740991)

Examples

curl -X POST "https://browlix.com/api/public/v1/sessions/ensure" \
  -H "Authorization: Bearer $BROWLIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotency_key":"<idempotency_key>","profile_id":"<profile_id>","device_id":"<device_id>"}'

Response

200 with { data, correlation_id }.

The field list of this reply is not published yet; read data as JSON.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
VALIDATION_FAILED422No
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations

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