Update an agent
PATCH/agents/:agent_id
Changes the fields of an agent that the request names, and keeps the stored value of every omitted field. prompt, placeholders and metadata replace the stored values whole, and description accepts null to clear the description. Foundation4 validates the resulting prompt template and placeholders with the rules of agent creation, including stored values that the request leaves unchanged.
Permissions. Write on the agent.
Agents and prompt templates describes prompt templates and placeholders.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 501
The agent was updated. The body is the updated agent.
The prompt template or a placeholder breaks a validation rule (Invalid prompt type, Invalid prompt or Invalid placeholder of type <placeholder>).
The authentication headers are missing or invalid, or the API key is inactive or expired. Errors lists the messages.
The license is not valid (Invalid license: <reason>).
No agent with this identifier exists, or the key lacks write permission on the agent (Agent with id <id> not found).
Another agent already has the requested name (Conflict unique error).
A placeholder has the type hybrid or history, which agents do not implement (Not implemented).