Replace complete agent draft spec

PUT 
https://platform.docana.com/api/v1/agents/:agentId/spec/

Replaces the full draft AgentSpec V2; it is not a patch and never publishes. The path agentId overwrites spec.id. In this REST endpoint Agent.name is canonical: update the agent name with updateAgent first, then submit the same normalized spec.name. Pass branchId to write the new version to a variant branch instead of the main draft.

Request

Responses

200

The new draft artifact version.

400

Invalid path or complete replacement body

401

The API key or session is missing, expired, or malformed.

403

No access to the application

404

Agent, or branch of this agent, not found in the application

409

The base version is stale, or branchId is not a variant branch

422

The spec has blocking mustFix defects and was not persisted

500

Unexpected server error.