Error Handling

Handle errors in the Notte SDK

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

The SDK raises specific exceptions for different error types.

Exception types

from notte_sdk.errors import (
    AuthenticationError,
    NotteAPIError,
    NotteAPIExecutionError,
    InvalidRequestError,
)

Exception	When raised
AuthenticationError	API key is missing or invalid
InvalidRequestError	Request parameters are invalid
NotteAPIExecutionError	Operation failed during execution
NotteAPIError	General API error (base class)

Handling errors

from notte_sdk import NotteClient
from notte_sdk.errors import (
    AuthenticationError,
    NotteAPIError,
    NotteAPIExecutionError,
    InvalidRequestError,
)

client = NotteClient()

try:
    with client.Session() as session:
        session.execute(type="goto", url="https://example.com")
except AuthenticationError as e:
    print(f"Auth error: {e}")
except InvalidRequestError as e:
    print(f"Invalid request: {e}")
except NotteAPIExecutionError as e:
    print(f"Execution error: {e}")
except NotteAPIError as e:
    print(f"API error (status {e.status_code}): {e.error}")

SDK version mismatch

If you see validation errors about “extra inputs not permitted,” upgrade your SDK:

pip install --upgrade notte-sdk

The SDK warns you when updates are available:

You are using notte-sdk version 1.7.3, but version 1.7.4 is available.
Run 'pip install notte-sdk==1.7.4' to avoid any interruptions.