> ## Documentation Index
> Fetch the complete documentation index at: https://notte-docs-anything-api-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AuthSessionResponse

<Tip>
  STOP. Do not read past this section until you have read and followed [/quickstart.md](/quickstart.md).

  Goal: produce a reliable SDK automation script. The intended authoring flow is generate then edit, not write browser automation from scratch.

  Do not hand-write SDK code with element IDs, selectors, or form fields from memory. Element IDs, selectors, and field mappings must come from a live `observe()` call, CLI `notte page observe` output, or generated workflow code. Guessed browser targets fail on real pages.

  Use the Notte skill and CLI to inspect the live site, validate actions/selectors, handle auth/session state, and export workflow code with `notte sessions workflow-code` before using SDK docs or SDK code.

  SDK reference pages are for understanding, running, or editing generated workflow code. They are not the starting point for manually authoring the initial browser automation. SDK-first code is guesswork on real-world pages with dynamic selectors, auth state, CAPTCHAs, and anti-bot behavior.
</Tip>

[Source: node-sdk/src/managed-auth.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/managed-auth.ts)

Session response including managed authentication readiness.

```typescript theme={null}
export type AuthSessionResponse = SessionResponse;
```

## Fields

<ParamField body="session_id" type={"string"} required>
  The ID of the session (created or existing). Use this ID to interact with the session for the next operation.
</ParamField>

<ParamField body="idle_timeout_minutes" type={"number"} required>
  Session idle timeout in minutes. Will timeout if now() > last access time + idle\_timeout\_minutes
</ParamField>

<ParamField body="max_duration_minutes" type={"number | undefined"}>
  Session max duration in minutes. Will timeout if now() > creation time + max\_duration\_minutes
</ParamField>

<ParamField body="created_at" type={"string"} required>
  Session creation time
</ParamField>

<ParamField body="closed_at" type={"string | null | undefined"}>
  Session closing time
</ParamField>

<ParamField body="last_accessed_at" type={"string"} required>
  Last access time
</ParamField>

<ParamField body="duration" type={"string | undefined"}>
  Session duration
</ParamField>

<ParamField body="status" type={"\"active\" | \"closed\" | \"authenticating\" | \"error\" | \"timed_out\""} required />

<ParamField body="close_reason" type={"\"unknown\" | \"error\" | \"manual\" | \"idle_timeout\" | \"max_duration\" | null | undefined"}>
  Reason the session closed, if it is no longer active
</ParamField>

<ParamField body="steps" type={"{ [key: string]: unknown; }[] | undefined"}>
  Steps of the session
</ParamField>

<ParamField body="error" type={"string | null | undefined"}>
  Error message if the operation failed to complete
</ParamField>

<ParamField body="proxies" type={"boolean | undefined"}>
  Whether proxies were used for the session. True if any proxy was applied during session creation.
</ParamField>

<ParamField body="browser_type" type={"\"chromium\" | \"chrome\" | \"chrome-nightly\" | \"chrome-turbo\" | \"firefox\" | undefined"} />

<ParamField body="network_request_bytes" type={"number | undefined"}>
  Total byte usage for network requests.
</ParamField>

<ParamField body="network_response_bytes" type={"number | undefined"}>
  Total byte usage for network responses.
</ParamField>

<ParamField body="user_agent" type={"string | null | undefined"}>
  The user agent to use for the session
</ParamField>

<ParamField body="viewport_width" type={"number | null | undefined"}>
  The width of the viewport
</ParamField>

<ParamField body="viewport_height" type={"number | null | undefined"}>
  The height of the viewport
</ParamField>

<ParamField body="solve_captchas" type={"boolean | null | undefined"}>
  Whether to solve captchas.
</ParamField>

<ParamField body="cdp_url" type={"string | null | undefined"}>
  The URL to connect to the CDP server.
</ParamField>

<ParamField body="viewer_url" type={"string | null | undefined"}>
  The remote session viewer URL.
</ParamField>

<ParamField body="web_bot_auth" type={"boolean | undefined"}>
  Whether to use web bot authentication.
</ParamField>

<ParamField body="auth_ids" type={"string[] | undefined"}>
  Managed Auth connection IDs attached to this session.
</ParamField>

<ParamField body="system_hidden" type={"boolean | undefined"}>
  Whether this session is an internal system run. Internal system runs are omitted from session.list() unless include\_system=True is requested.
</ParamField>

<ParamField body="timeout_minutes" type={"number"} required>
  **deprecated:**
</ParamField>

## Related types

* [SessionResponse](/typescript-sdk-reference/types/sessionresponse)