---
title: "Agent Start"
method: POST
path: "/agents/start"
tags: ["agents"]
---

# Agent Start

`POST /agents/start`

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- ApiAgentStartRequest
  - `task` string, required — The task that the agent should perform
  - `url` string, nullable — The URL that the agent should start on (optional)
  - `response_format` unknown
  - `session_offset` integer, nullable — [Experimental] The step from which the agent should gather information from in the session. If none, fresh memory
  - `reasoning_model` union — The reasoning model to use
    - 'openai/gpt-4o' | 'gemini/gemini-2.5-flash' | 'vertex_ai/gemini-2.5-flash' | 'openrouter/google/gemma-3-27b-it' | 'cerebras/gpt-oss-120b' | 'groq/gpt-oss-120b' | 'perplexity/sonar-pro' | 'deepseek/deepseek-r1' | 'together_ai/meta-llama/llama-3.3-70b-instruct' | 'anthropic/claude-sonnet-4-5-20250929' | 'moonshot/kimi-k2.5' | 'xai/grok-4-1-fast-non-reasoning' | 'minimax/minimax-m2.5'
    - string
  - `use_vision` boolean — Whether to use vision for the agent. Not all reasoning models support vision.
  - `max_steps` integer — The maximum number of steps the agent should take
  - `vault_id` string, nullable — The vault to use for the agent
  - `persona_id` string, nullable — The persona to use for the agent
  - `notifier_config` object, nullable — Config used for the notifier
  - `session_id` string, required — The ID of the session to run the agent on

## Response `200`

Successful Response

- AgentResponse
  - `agent_id` string, required — The ID of the agent
  - `created_at` string, date-time, required — The creation time of the agent
  - `session_id` string, required — The ID of the session
  - `status` 'active' | 'closed', required
  - `closed_at` string, date-time, nullable — The closing time of the agent
  - `saved` boolean — Whether the agent is saved as a workflow

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/notte/apis/notte-api.md) · [All operations](https://skmtc.net/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notte/notte-api/versions/8dda4e3d49cc/schema)