Artifacts
Create, upload, and retrieve artifacts produced by agent sessions
List Artifacts Endpoint
Query Parameters
workflow_id?|
Filter by workflow ID
phase_id?|
Filter by phase ID
artifact_type?|
Filter by artifact type
limit?integer
Max items to return
Default
50Range
1 <= value <= 200Response Body
application/json
application/json
curl -X GET "https://loading/artifacts"[
{
"id": "string",
"workflow_id": "string",
"phase_id": "string",
"artifact_type": "string",
"title": "string",
"size_bytes": 0,
"created_at": "string"
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Create Artifact Endpoint
Request Body
application/json
workflow_id*string
artifact_type*string
title*string
content*string
phase_id?|
session_id?|
content_type?string
Default
"text/markdown"[key: string]?never
Response Body
application/json
application/json
curl -X POST "https://loading/artifacts" \ -H "Content-Type: application/json" \ -d '{ "workflow_id": "string", "artifact_type": "string", "title": "string", "content": "string" }'{
"id": "string",
"title": "string",
"artifact_type": "string",
"status": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Artifact Endpoint
Path Parameters
artifact_id*string
Query Parameters
include_content?boolean
Include artifact content in response
Default
trueResponse Body
application/json
application/json
curl -X GET "https://loading/artifacts/string"{
"id": "string",
"workflow_id": "string",
"phase_id": "string",
"session_id": "string",
"artifact_type": "string",
"is_primary_deliverable": true,
"content": "string",
"content_type": "text/markdown",
"content_hash": "string",
"size_bytes": 0,
"title": "string",
"derived_from": [
"string"
],
"created_at": "string",
"created_by": "string",
"metadata": {}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Artifact Content Endpoint
Path Parameters
artifact_id*string
Response Body
application/json
application/json
curl -X GET "https://loading/artifacts/string/content"{
"artifact_id": "string",
"content": "string",
"content_type": "string",
"size_bytes": 0
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Upload Artifact Endpoint
Path Parameters
artifact_id*string
Request Body
multipart/form-data
file*file
Format
binaryResponse Body
application/json
application/json
curl -X POST "https://loading/artifacts/string/upload" \ -F file="string"{
"artifact_id": "string",
"storage_url": "string",
"status": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Syntropic137 Docs v0.18.0 · Last updated March 2026