Skip to main content
POST
Materialize Agent Profile

Authorizations

X-Access-Token
string
header
required

Path Parameters

name
string
required
Required string length: 1 - 64
Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

Query Parameters

org_id
string<uuid> | null

Response

Successful Response

Side-effect-free report of what :func:resolve_agent_profile would do.

Consumed by POST /{id}/materialize (#3719) and the canvas editor. The verdict (:attr:valid) and the dangling-ref lists match exactly what a real resolve produces; :attr:resolved_settings is the redacted settings dump (present only when :attr:valid).

agent_kind
string
required
valid
boolean
default:false
errors
string[]
llm_profile_ref
string | null
llm_profile_resolved
boolean
default:false
llm_api_key_set
boolean
default:false
mcp_server_refs
string[] | null
resolved_mcp_config_keys
string[]
resolved_mcp_servers
string[]

Deprecated alias for resolved_mcp_config_keys.

dangling_mcp_server_refs
string[]
disabled_skills
string[]
resolved_skills
string[]
acp_api_key_secret_name
string | null
acp_base_url_secret_name
string | null
acp_file_secret_names
string[]
resolved_settings
Resolved Settings · object | null