Update agent identity
PATCH/v2/agents/:agent_key/identity
Updates the agent's identity. You can change the role management mode, the roles, or both.
Setting mode to manual freezes the current roles. The platform no longer recomputes roles when the agent's tool configuration changes. This is useful when you need to grant the agent additional permissions beyond what its tools require.
Setting mode to auto resumes platform-managed roles. The platform immediately resyncs the roles to match the current tool configuration.
Request
Responses
- 200
- 400
- 403
- 404
The updated agent identity.
Invalid request.
Permissions do not allow modifying this agent.
Agent not found.