Skip to main content
POST
Save an artifact
This operation writes a new version to the configured artifact store. Repeating the same request can create another version. Confirm the content and target application, user, and session before saving
Use artifact.text for text. For binary content, use artifact.inlineData with mimeType and Base64-encoded data. Read the exact saved version using the returned version; direct access to canonicalUri depends on the storage backend and permissions

Authorizations

Authorization
string
header
required

Optional locally without a gateway; cloud deployments use the Runtime API key or user-pool JWT required by that deployment, never the model API key

Path Parameters

app_name
string
required

Application name; harness_agent for the CLI deployment

user_id
string
required

User ID

session_id
string
required

Session ID

Body

application/json
filename
string
required

Artifact filename

artifact
Part · object
required

Artifact content represented as a Part

customMetadata
Custommetadata · object | null

Custom metadata

Response

Successful response

version
integer
required

Monotonically increasing artifact version number

canonicalUri
string
required

Canonical URI of the stored artifact

customMetadata
Custommetadata · object

Custom metadata

createTime
number

Creation time as a Unix timestamp in seconds

mimeType
string | null

Content MIME type

Last modified on September 19, 2026