Skip to main content

Max Agent Steps

When an agent uses tools, it works in steps: each response from the model counts as one step, whether it returns a message, a single tool call, or several tool calls at once. The maxAgentSteps query parameter lets you override the maximum number of steps allowed for a single execution. The value must be an integer from 1 to 500. If you don’t set it, the execution defaults to 100 steps. A value outside that range returns a 400 error rather than being clamped.
This is most relevant for agentic agents that call tools. Lowering the limit can cap latency and cost; raising it gives complex, multi-step tasks more room to complete.

Example with maxAgentSteps

Add the maxAgentSteps query parameter to your execution request.