Diff two agent specs
POSThttps://platform.docana.com/api/v1/agents/diff/
Compares two agent specs and reports the semantic changes between them: workflow nodes added, removed or modified; reasonings (decision-node evaluation criteria, matched by name) added, removed or modified; nodes whose routing rules (transitions) changed; and changed top-level fields. changes.details lists, per node, each changed field: prose with its before/after text, routing rules as conditions in words, and reasonings by name. Each side is an agent in this deployment (agentId) or an inline spec / export bundle (spec), so two different agents can be compared — for example a production agent against its development copy. Specs are normalized before comparison (ids, per-environment criteria references and the owning agent stamped on each criterion are neutralized; sub-agent nodes that only point to a different agent are listed apart in changes.referencesChanged), and the normalized specs are returned for stable textual diffs.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
The semantic diff between the two specs
The request body, query, or path failed validation. See validationErrors.
The API key or session is missing, expired, or malformed.
No access to a referenced agent
A referenced agent was not found
Unexpected server error.