> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clear browser state

> Clears the stored browser state (cookies, localStorage, and sessionStorage) for a specific vault entry.

After clearing, the next workflow execution using this vault entry will perform a fresh login instead of restoring the cached browser session.

This is useful when:
- The stored browser state causes errors or unexpected behavior during runs
- You've updated the vault entry's credentials and want to force a fresh login
- You're debugging a failing workflow and want to rule out stale browser state as the cause



## OpenAPI

````yaml vault-api/vault-api.yaml patch /vault/clear-browser-state
openapi: 3.1.0
info:
  title: CloudCruise Vault API
  version: 0.1.0
  description: Endpoints for managing vault entries.
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /vault/clear-browser-state:
    patch:
      summary: Clear browser state
      description: >-
        Clears the stored browser state (cookies, localStorage, and
        sessionStorage) for a specific vault entry.


        After clearing, the next workflow execution using this vault entry will
        perform a fresh login instead of restoring the cached browser session.


        This is useful when:

        - The stored browser state causes errors or unexpected behavior during
        runs

        - You've updated the vault entry's credentials and want to force a fresh
        login

        - You're debugging a failing workflow and want to rule out stale browser
        state as the cause
      operationId: vault_clear_browser_state
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VaultClearBrowserStateRequest'
      responses:
        '200':
          description: Browser state successfully cleared
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Whether the operation succeeded
        '400':
          description: >-
            Invalid request. Missing required fields (permissioned_user_id,
            domain) or authentication headers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                statusCode: 400
                message: Invalid request
                error: Bad Request
        '401':
          description: Unauthorized. Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                statusCode: 401
                message: Unauthorized
                error: Unauthorized
components:
  schemas:
    VaultClearBrowserStateRequest:
      type: object
      description: Request payload for clearing browser state of a vault entry
      properties:
        permissioned_user_id:
          type: string
          description: Unique identifier of the vault entry
        domain:
          type: string
          description: Target domain of the vault entry
      required:
        - permissioned_user_id
        - domain
    ErrorResponse:
      type: object
      description: Error response returned when a request fails
      properties:
        statusCode:
          type: integer
          description: HTTP status code
        message:
          type: string
          description: Human-readable error message
        error:
          type: string
          description: HTTP status text (e.g., "Not Found", "Conflict")
      required:
        - statusCode
        - message
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````