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

# execute

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) 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.
</Tip>

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

Execute an action on the current page.

When the action fails and `raiseOnFailure` is true (the default, see the
session option), the structured `exception_detail` returned by the API is
rehydrated into an `ActionExecutionError` whose `errorType` names the
server-side error class. `captcha_solve` actions get a 100 s request
timeout and are retried up to 3 times on HTTP 408.

```typescript theme={null}
Session.execute(action: ExecuteAction, options?: boolean | ExecuteOptions): Promise<CaptchaExecutionResponse>;
```

## Parameters

<ParamField body="action" type={"ExecuteAction"} required>
  Action type, target, and action-specific arguments.
</ParamField>

<ParamField body="options" type={"boolean | ExecuteOptions"}>
  Override failure handling for this call; otherwise use the session setting.

  Default:

  ```typescript theme={null}
  {}
  ```
</ParamField>

## Returns

```typescript theme={null}
Promise<CaptchaExecutionResponse>
```

The execution response, including `success` and failure details when throwing is disabled.

## Raises

* ActionExecutionError if the action fails and failure throwing is enabled.
* NotteAPIError if the API request fails.

## Example

```typescript theme={null}
import { actions } from 'notte-sdk';

await session.execute({ type: 'goto', url: 'https://www.notte.cc' });
await session.execute(actions.fill({ selector: "input[name='email']", value: 'user@example.com' }));
const result = await session.execute({ type: 'click', id: 'B1' }, { raiseOnFailure: false });
if (!result.success) console.log(result.message);
```

## Related types

* [CaptchaExecutionResponse](/typescript-sdk-reference/types/captchaexecutionresponse)
* [ExecuteAction](/typescript-sdk-reference/types/executeaction)
* [ExecuteOptions](/typescript-sdk-reference/types/executeoptions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.