Skip to main content

Model Override

By default, Logic automatically routes your agent execution to the optimal model based on your agent’s requirements. However, you can bypass this routing and explicitly specify which model and reasoning level to use by adding the model query parameter.
Model overrides are an advanced feature. In most cases, Logic’s automatic model routing will select the best model for your use case. Only use model overrides when you have specific requirements around model selection.

Available Models

The model parameter accepts a model identifier in the format {model}:{reasoning_level}.

Reasoning Levels

The reasoning level controls how much “thinking” the model does before responding:
  • none/default — Standard response without extended reasoning
  • minimal — Light reasoning for simple tasks
  • low — Basic reasoning for straightforward problems
  • medium — Moderate reasoning for complex tasks
  • high — Maximum reasoning for the most challenging problems
Higher reasoning levels may increase latency and cost but can improve accuracy for complex tasks.

Capability Validation

When using a model override, Logic validates that your chosen model supports your agent’s requirements. If your agent requires capabilities the model doesn’t support, you’ll receive a 400 InvalidModelOverride error. For example, if your agent processes audio input and you specify ?model=gpt-5.1:low, the request will fail because OpenAI models don’t support audio processing.

Example Usage

Below are examples showing how to specify a model override when executing an agent.

Error Handling

If you specify an invalid model or a model that doesn’t support your agent’s requirements, you’ll receive a 400 InvalidModelOverride error: