agents

Refresh and cache the model picker for one agent

post/api/v1/agents/{agent}/models/refresh

Request

agentstring required

Agent adapter identifier.

catalogOnlyboolean

Refresh the Harness Settings browsing catalog without session-history enrichment; FX includes all connections in a separate cache.

projectIdstring

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

revalidateboolean

When true, compare executable and config metadata before running discovery.

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'