Skip to main content
GET
/
api
/
v1
/
tasks
/
{id}
/
artifacts
Artifacts
curl --request GET \
  --url https://api.example.com/api/v1/tasks/{id}/artifacts

​
Artifacts

Retrieve files generated in a task’s workspace. This includes uploaded files, generated outputs, and any files created by the agent during execution.

​
List Artifacts

GET /api/v1/tasks/{id}/artifacts
Authorization: Bearer {api_key}

​
Path Parameters

ParameterTypeDescription
idstringThe unique task identifier

​
Response

{
  "success": true,
  "data": {
    "files": [
      {
        "name": "output.csv",
        "path": "downloads/output.csv",
        "size": 1024,
        "mimeType": "text/csv",
        "category": "csv",
        "modifiedAt": "2026-01-26T16:00:00.000Z"
      },
      {
        "name": "report.pdf",
        "path": "downloads/report.pdf",
        "size": 50432,
        "mimeType": "application/pdf",
        "category": "pdf",
        "modifiedAt": "2026-01-26T16:01:00.000Z"
      },
      {
        "name": "data.csv",
        "path": "uploads/data.csv",
        "size": 2048,
        "mimeType": "text/csv",
        "category": "csv",
        "modifiedAt": "2026-01-26T15:50:00.000Z"
      }
    ]
  }
}

​
File Object

FieldTypeDescription
namestringFilename
pathstringRelative path in workspace
sizenumberFile size in bytes
mimeTypestringMIME type (e.g., text/csv, application/pdf)
categorystringFile category (e.g., csv, pdf, image, code)
modifiedAtstringISO timestamp of last modification
This endpoint works for both active sessions and completed tasks. When a session has expired, files are retrieved from the preserved workspace.

​
Examples

curl -s https://api.sigmic.ai/api/v1/tasks/YOUR_TASK_ID/artifacts \
  -H "Authorization: Bearer sigmic_your_key_here" | jq

​
Download Artifact

Download a specific file from the task’s workspace. 
GET /api/v1/tasks/{id}/artifacts/download?path={filePath}
Authorization: Bearer {api_key}

​
Path Parameters

ParameterTypeDescription
idstringThe unique task identifier

​
Query Parameters

ParameterTypeRequiredDescription
pathstringYesRelative file path (from the artifacts listing)

​
Response

Binary file content with the following headers:
HeaderDescription
Content-TypeMIME type of the file
Content-Dispositionattachment; filename="output.csv"
Content-LengthFile size in bytes

​
Examples

# Download to current directory
curl -O https://api.sigmic.ai/api/v1/tasks/YOUR_TASK_ID/artifacts/download?path=downloads/output.csv \
  -H "Authorization: Bearer sigmic_your_key_here"

# Save with custom filename
curl -o my-report.pdf https://api.sigmic.ai/api/v1/tasks/YOUR_TASK_ID/artifacts/download?path=downloads/report.pdf \
  -H "Authorization: Bearer sigmic_your_key_here"

​
Use Cases

Download Reports

Retrieve generated reports, analysis results, or data exports

Access Uploaded Files

Download files that were uploaded with the task for verification

Build File Browsers

List workspace contents and let users browse generated artifacts

Pipeline Integration

Automatically retrieve output files as part of an automation pipeline

​
Errors

CodeDescription
AUTH_REQUIREDNo authentication provided
INVALID_API_KEYInvalid or expired API key
NOT_FOUNDTask or file not found
VALIDATION_ERRORMissing path query parameter (download endpoint)