Skip to main content
GET
/
api
/
v1
/
admin
/
agents
/
{agentId}
curl -X GET https://alfred.black/api/v1/admin/agents/vault-curator \
  -H "Authorization: Bearer alf_your_key_here"

{
  "defaultModel": "anthropic/claude-sonnet-4",
  "resolvedDefault": "anthropic/claude-sonnet-4",
  "fallbacks": ["openai/gpt-4o"],
  "providers": [
    { "provider": "openrouter", "status": "configured", "source": "env" },
    { "provider": "anthropic", "status": "missing", "source": null }
  ],
  "missingProviders": []
}
Returns the full model status for a single agent, including the resolved model, fallbacks, and provider credential status. For OpenClaw agents (main, vault-curator, vault-janitor, vault-distiller), this runs openclaw models status inside the container. For surveyor, it reads the config.yaml file directly.
​
agentId
string
required
Agent identifier. One of main, vault-curator, vault-janitor, vault-distiller, surveyor.

​
Response (OpenClaw agent)

​
defaultModel
string | null
The model explicitly set for this agent, or null if using the global default.
​
resolvedDefault
string | null
The model that will actually be used, after resolving defaults and fallbacks.
​
fallbacks
string[]
Ordered list of fallback models if the default is unavailable.
​
providers
array
Status of each credential provider relevant to this agent.
​
missingProviders
string[]
Providers required by the current model configuration but not yet configured.

​
Response (Surveyor)

​
labeler_model
string
Model used for cluster labeling.
​
embedder_model
string
Model used for embedding vault records.
​
embedder_source
string
Where embeddings are generated. Either ollama (local) or openrouter (remote).

​
Request Example

curl -X GET https://alfred.black/api/v1/admin/agents/vault-curator \
  -H "Authorization: Bearer alf_your_key_here"

​
Response Example

{
  "defaultModel": "anthropic/claude-sonnet-4",
  "resolvedDefault": "anthropic/claude-sonnet-4",
  "fallbacks": ["openai/gpt-4o"],
  "providers": [
    { "provider": "openrouter", "status": "configured", "source": "env" },
    { "provider": "anthropic", "status": "missing", "source": null }
  ],
  "missingProviders": []
}