Skip to main content

Materialize agent profile

POST /api/agent-profiles/{name}/materialize

Dry-run resolve a profile's LLM/MCP references into a diagnostics report. Dangling refs are reported in the body (valid=False), not raised; the only error status is 404 (unknown profile name). resolved_settings is redacted. Delegates entirely to resolve_agent_profile_dry_run.

Parameters

NameInTypeRequiredDescription
namepathstringyes
org_idquery`stringnull`no

Responses

StatusDescription
200Successful Response
422Validation Error

Response body

FieldTypeRequiredDescription
agent_kindstringyes
validbooleanno
errorsstring[]no
llm_profile_ref`stringnull`no
llm_profile_resolvedbooleanno
llm_api_key_setbooleanno
mcp_server_refs`string[]null`no
resolved_mcp_config_keysstring[]no
resolved_mcp_serversstring[]noDeprecated alias for resolved_mcp_config_keys.
dangling_mcp_server_refsstring[]no
disabled_skillsstring[]no
resolved_skillsstring[]no
acp_api_key_secret_name`stringnull`no
acp_base_url_secret_name`stringnull`no
acp_file_secret_namesstring[]no
resolved_settings`objectnull`no

Operation ID: materialize_agent_profile_api_agent_profiles__name__materialize_post