Artifacts API

Programmatic access to artifacts: list, push, promote, and inspect provenance.

Endpoints

Method	Path	Description
GET	/v1/artifacts	List artifacts in the current org
GET	/v1/artifacts/:id	Get a single artifact and its versions
POST	/v1/artifacts/:id/versions	Push a new version
POST	/v1/artifacts/:id/promote	Promote a version to an environment
DELETE	/v1/artifacts/:id/versions/:v	Delete a version (admin only)

Example: push a version

POST /v1/artifacts/web/versions
Content-Type: application/json

{
  "version": "2.4.1",
  "digest": "sha256:8f2d…b7e1",
  "type": "oci-image",
  "provenance": { "builder": "catalyst", "slsa": "v1.0" }
}