DiscoverAgentModelsRequest

The models route's optional body. With refresh, the agent's list is rebuilt before it is answered: the session host re-probes the agent and lists it again, as it does after a CLI update. A request already rebuilding the same agent's list is joined, not repeated. With no body, the list already known is answered.

Type object

Shape

Field	Type	Description
refresh	boolean	Default `false`

Example

{
  "refresh": false
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/ai/providers/{provider}/models
List the models a local agent offers

Generated from contract version 1. Last updated November 12, 2026.