Skip to main content
Section ID: DOC-API-MODEL-schema-ohmse4h323#overview

AgentProfileMetadata

Profile identity and selection hints for a picker or router. This projection excludes the system prompt, generation settings, tools and MCP configuration; retrieve AgentProfile to inspect the runtime configuration. These hints do not establish that routing is active.

Meaning and usage​

Section ID: DOC-API-MODEL-schema-ohmse4h323#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-ohmse4h323#fields

UsageFields and validation
In responsesView fields

In responses​

Section ID: DOC-API-MODEL-schema-ohmse4h323#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-ohmse4h323#field-profileidSection ID: DOC-API-MODEL-schema-ohmse4h323#response-field-profileidprofileIdstringOptionalIdentifier of the agent profile associated with the operation or generation.
Section ID: DOC-API-MODEL-schema-ohmse4h323#field-nameSection ID: DOC-API-MODEL-schema-ohmse4h323#response-field-namenamestringOptionalDisplay name used when presenting an agent profile in the library.
Section ID: DOC-API-MODEL-schema-ohmse4h323#field-descriptionSection ID: DOC-API-MODEL-schema-ohmse4h323#response-field-descriptiondescriptionstringOptionalHuman-readable description of the resource.
Section ID: DOC-API-MODEL-schema-ohmse4h323#field-whentouseSection ID: DOC-API-MODEL-schema-ohmse4h323#response-field-whentousewhenToUsestringOptionalInstructions describing when this agent profile should be selected.
Section ID: DOC-API-MODEL-schema-ohmse4h323#field-keywordsSection ID: DOC-API-MODEL-schema-ohmse4h323#response-field-keywordskeywordsArray of stringOptionalKeywords associated with discovery or selection of the agent profile.
Section ID: DOC-API-MODEL-schema-ohmse4h323#field-enabledSection ID: DOC-API-MODEL-schema-ohmse4h323#response-field-enabledenabledbooleanOptionalWhether this configuration is enabled.

Where used​

Section ID: DOC-API-MODEL-schema-ohmse4h323#where-used

ReferenceRelationship
Get the profile libraryPOST /api/v1/agent-profiles/library
Models containing this value
ModelRelationship
AgentProfileLibraryNested in model

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-ohmse4h323