Artifacts
Create, upload, and retrieve artifacts produced by agent sessions
List Artifacts Endpoint
Query Parameters
Filter by workflow ID
Filter by execution ID
Filter by phase ID
Filter by session ID
Filter by artifact type
Inclusive ISO 8601 lower bound on created_at (timezone required)
Inclusive ISO 8601 upper bound on created_at (timezone required)
Case-insensitive substring match against artifact id, title, workflow id and phase id
Page number
11 <= valueItems per page
Deprecated alias for page_size. Ignored when page_size is given.
Response Body
application/json
application/json
curl -X GET "https://loading/artifacts"{
"artifacts": [
{
"id": "string",
"workflow_id": "string",
"execution_id": "string",
"phase_id": "string",
"artifact_type": "string",
"title": "string",
"size_bytes": 0,
"created_at": "string",
"agent_provider": "string",
"agent_model": "string"
}
],
"total": 0,
"page": 1,
"page_size": 50,
"excluded_undated": 0,
"type_counts": {
"property1": 0,
"property2": 0
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Create Artifact Endpoint
Request Body
application/json
"text/markdown"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",
"input": null,
"ctx": {}
}
]
}Get Artifact Endpoint
Path Parameters
Query Parameters
Include artifact content in response
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": {},
"agent_provider": "string",
"agent_model": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Delete Artifact Endpoint
Path Parameters
Response Body
application/json
application/json
curl -X DELETE "https://loading/artifacts/string"{
"artifact_id": "string",
"status": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Update Artifact Endpoint
Path Parameters
Request Body
application/json
Response Body
application/json
application/json
curl -X PUT "https://loading/artifacts/string" \ -H "Content-Type: application/json" \ -d '{}'{
"artifact_id": "string",
"status": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Get Artifact Content Endpoint
Path Parameters
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",
"input": null,
"ctx": {}
}
]
}Upload Artifact Endpoint
Path Parameters
Request Body
multipart/form-data
Response 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",
"input": null,
"ctx": {}
}
]
}Syntropic137 Docs v0.33.1 · Last updated March 2026