Skip to main content

Update an agent profile

POST 

/api/v1/agent-profiles/update

Updates an agent profile. Each successful update appends a new immutable version; the profile ID remains fixed and the store assigns the version.

Which fields change

Without an updateMask, only the fields the supplied profile sets change, and inside generationConfig only the sub-fields it sets. Nothing left out is cleared, so clearing a field needs a mask. A mask naming fields changes exactly those, clearing a named field the profile leaves unset; to replace the whole profile, name every field. An update that would leave name or whenToUse empty is refused with 400, as is one writing a system prompt that is not a valid template or variable specs without unique names.

Request​

Responses​

Profile updated; the new stored record is echoed back

Document ID: DOC-MA-profiles-prompts-api-updateAgentProfile. Section identities and revisions.

SectionStable reference
OverviewDOC-MA-profiles-prompts-api-updateAgentProfile#overview
RequestDOC-MA-profiles-prompts-api-updateAgentProfile#request
ResponsesDOC-MA-profiles-prompts-api-updateAgentProfile#responses