Create or update an artifact
POSThttps://platform.docana.com/api/v1/artifacts/
When artifact.id matches an existing artifact it is updated (as an unpublished draft when draft is true). Agent-spec drafts and artifacts referenced by an agent, branch or historical experiment append a version; ordinary drafts update in place. honouring an optional If-Match version precondition; otherwise a new artifact is created in the application collection. artifact.kind is a storage-level format (for example json or markdown). Saving a JSON artifact does not create, link, validate, or publish an Agent; use the semantic createAgent operation to create a draft agent and its linked spec artifact.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 412
- 500
The saved artifact (the ETag header carries the version on updates)
Invalid body
The API key or session is missing, expired, or malformed.
An interface artifact the user can open but not change: another member's, without write permission on its collection
artifact.id names an artifact the user cannot see, or an interface in a collection the user cannot open. A save never answers it with a new artifact
Version conflict: the If-Match precondition failed
Unexpected server error.