This is a test.
", "markdown": "# Example Domain\n\nThis is a test.", "textContent": "Example Domain\n\nThis is a test.", "title": "Example Domain" } ``` --- ### 2. Navigate to a URL Commands the session's active page to navigate to a target website. * **Endpoint**: `POST /computers/:id/browser/sessions/:sessionId/navigate` * **Body**: ```json { "url": "https://example.com" } ``` * **Response**: ```json { "success": true, "message": "Successfully navigated to https://example.com" } ``` ### 3. Take Page Screenshot Capture the current visual state of the browser. Supports capturing the visible screen or the entire page height. * **Endpoint**: `GET /computers/:id/browser/sessions/:sessionId/screenshot` * **Query Parameters**: - `fullPage` (boolean, optional): Set to `true` to capture a full-page scroll screenshot. * **Response**: Binary PNG stream (`Content-Type: image/png`). ### 4. Click Elements Click a specific HTML selector or specific coordinates on the active page. * **Endpoint**: `POST /computers/:id/browser/sessions/:sessionId/click` * **Body** (Selector-based): ```json { "selector": "button.submit" } ``` * **Body** (Coordinate-based): ```json { "x": 250, "y": 480 } ``` * **Response**: ```json { "success": true } ``` ### 5. Type Text Types text string using the keyboard simulator on the currently focused element. * **Endpoint**: `POST /computers/:id/browser/sessions/:sessionId/type` * **Body**: ```json { "text": "Autonomous Agent" } ``` * **Response**: ```json { "success": true } ``` ### 6. Evaluate Javascript Script Evaluates code in the context of the active page and returns the serialized JSON result. * **Endpoint**: `POST /computers/:id/browser/sessions/:sessionId/evaluate` * **Body**: ```json { "script": "document.title" } ``` * **Response**: ```json { "result": "Example Domain" } ``` ### 7. Close Session Immediately terminates the browser instance and closes the session. * **Endpoint**: `DELETE /computers/:id/browser/sessions/:sessionId` * **Response**: ```json { "success": true, "message": "Browser session successfully closed." } ``` --- ## Concurrency Rate Limits To ensure platform stability and prevent resource abuse, Secrooq enforces a strict limit of **5 concurrent active browser sessions per computer**. * Attempting to create a 6th session will result in a `429 Too Many Requests` response. --- ## Error & Expiry Handling (404 Responses) If a browser session is terminated (either via explicit `DELETE`, auto-expiration, or remote edge closure), any subsequent page action endpoint request will: 1. Automatically transition the session status to `closed` in the database. 2. Return a `404 Not Found` response: ```json { "error": "Not Found", "message": "Browser session has been closed or is unavailable." } ``` --- ## Session Cleanup Lifecycle Secrooq executes automated maintenance processes to manage active edge browser connections: 1. **Idle Expiry (30 Minutes)**: Any session with no API activity for **30 minutes** is automatically disconnected and closed. 2. **Hard Limit (1 Hour)**: To prevent runaway processes, all active sessions are force-closed after **1 hour** from initial creation. 3. **Database Purge (30 Days)**: Closed session history metadata is automatically deleted from the relational database after **30 days** to keep telemetry logs lean.