Patch Agent Profile
Update only the supplied fields on an enrolled Agent identity. Omitted fields are preserved; empty or null values clear the field or restore its server default. The profile ID is immutable.
Path Parameters
agent_id*Agent Id
Canonical Agent profile ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Public wire contract for a partial Agent profile update.
The runtime handler deliberately keeps a JSON map so it can distinguish an
omitted field from a present null or empty value. This type is the
code-first OpenAPI contract for the same canonical field set.
Response Body
application/json
application/json
curl -X PATCH "https://example.com/settings/agent-profiles/string" \ -H "Content-Type: application/json" \ -d '{}'{ "defaultSpaceId": "string", "description": "string", "displayName": "string", "hostAgentId": "string", "id": "string", "instructions": "string", "role": "string", "sourceApp": "string", "tags": [ "string" ]}Empty
{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}