NOnotte
agents

Agent Start

Changed on
post/agents/start

Request

  • Base URL
    https://api.notte.cc (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: token

Headers

x-notte-request-originstring nullable
x-notte-sdk-versionstring nullable

Request body

taskstring required

The task that the agent should perform

urlstring nullable

The URL that the agent should start on (optional)

response_formatunknown
session_offsetinteger nullable

[Experimental] The step from which the agent should gather information from in the session. If none, fresh memory

use_visionboolean

Whether to use vision for the agent. Not all reasoning models support vision.

max_stepsinteger

The maximum number of steps the agent should take

vault_idstring nullable

The vault to use for the agent

persona_idstring nullable

The persona to use for the agent

notifier_configobject nullable

Config used for the notifier

session_idstring required

The ID of the session to run the agent on

Response

Successful Response

agent_idstring required

The ID of the agent

created_atstring date-time required

The creation time of the agent

session_idstring required

The ID of the session

status'active' | 'closed' required
closed_atstring date-time nullable

The closing time of the agent

savedboolean

Whether the agent is saved as a workflow

Changes

  • 5265494c1d7cRevision changes
    • breaking

      removed the enum value xai/grok-4-1-fast-non-reasoning of the request property /

    • info

      added the new xai/grok-4.3 enum value to the request property /

  • 98d1efa52c43Revision changes
    • breaking

      removed the enum value gemini/gemini-2.5-flash of the request property /

    • breaking

      removed the enum value vertex_ai/gemini-2.5-flash of the request property /

    • info

      added the new gemini/gemini-3.5-flash enum value to the request property /

    • info

      added the new vertex_ai/gemini-3.5-flash enum value to the request property /