POST
/
env
/
step
curl --location \
--request POST 'https://api.notte.cc/env/step' \
--header 'Content-Type: application/json' \
--data '{
  "session_id": "abc123",
  "action_id": "navigate",
  "value": "https://example.com",
  "enter": true
}'

{
  "session_id": "abc123",
  "title": "Example Domain",
  "url": "https://example.com",
  "timestamp": "2024-01-07T12:34:56Z",
  "screenshot": null,
  "data": "<html>...</html>",
  "space": {
    "description": "Available actions for the resulting page.",
    "category": "navigation",
    "actions": [
      {
        "id": "click",
        "name": "Click",
        "description": "Click on an element."
      }
    ]
  }
}

​
Parameters

​
session_id (req)
string

Required parameter to specify the session ID. The session ID of the active browser session.

​
action_id (req)
string

Required parameter to specify the action ID. The ID of the action to execute within the environment.

​
value (opt)
string

Optional parameter to provide input or parameters for the action. Specify any required input values for the action being executed.

​
enter (opt)
boolean

Optional parameter to specify whether to confirm the action (e.g., pressing Enter). Default is false.

​
Response

​
session_id
string

The unique identifier for the session where the action was executed.

​
title
string

The title of the resulting page after executing the action.

​
url
string

The URL of the resulting page after executing the action.

​
timestamp
string

The timestamp when the action was executed, in ISO 8601 format.

​
screenshot
string (base64) (opt)

A base64-encoded screenshot of the resulting page, if available.

​
data
string

The data retrieved from the resulting page after the action.

​
space
object (opt)

The available action space after the execution, including descriptions and categories.

​
Error Responses

​
400
string

Invalid request. This error is returned when the input parameters are not valid or a required parameter is missing.

​
500
string

Internal server error. This error is returned when the server encounters an unexpected condition.

curl --location \
--request POST 'https://api.notte.cc/env/step' \
--header 'Content-Type: application/json' \
--data '{
  "session_id": "abc123",
  "action_id": "navigate",
  "value": "https://example.com",
  "enter": true
}'

{
  "session_id": "abc123",
  "title": "Example Domain",
  "url": "https://example.com",
  "timestamp": "2024-01-07T12:34:56Z",
  "screenshot": null,
  "data": "<html>...</html>",
  "space": {
    "description": "Available actions for the resulting page.",
    "category": "navigation",
    "actions": [
      {
        "id": "click",
        "name": "Click",
        "description": "Click on an element."
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
action_id
string
required
​
session_id
string | null
​
keep_alive
boolean
default:false
​
session_timeout
integer
default:10
​
screenshot
boolean | null
​
value
string | null
​
enter
boolean
default:false

Response

200
application/json
Successful Response
​
session_id
string
required
​
title
string
required
​
url
string
required
​
timestamp
string
required
​
error
string | null
​
screenshot
file | null
​
data
string
default:
​
space
object | null