agents

Return the cached model picker for one agent, discovering it on first use

get/api/v1/agents/{agent}/models

Request

agentstring required

Agent adapter identifier.

catalogOnlyboolean

Return catalog facts without reading session history for model recency. Cached catalogs are served while discovery refreshes in the background.

projectIdstring

Optional cloud credential scope. Any other value, including a project identifier, is ignored: model catalogs are cached per device, not per project.

agentIdstring required

allowCustomboolean required

binaryVersionstring

configuredProvidersstring[]

customModelEntry'none' | 'direct' | 'configured' required

fetchedAtstring date-time required

inputFingerprintstring

lastSuccessAtstring date-time nullable

metadataobject

providersstring[]

refreshErrorstring

refreshRecommendedboolean

refreshState'idle' | 'queued' | 'refreshing' | 'error'

retryAtstring date-time nullable

runnableModelsstring[]

selectionMode'catalog' | 'text' | 'mode' required

sourcestring required

staleboolean required

validatedAtstring date-time

warningstring

warningCode'auth_required' | 'auth_expired'