Export evaluation items to a file

POST/v5/evaluation-items/export

Export all evaluation items for a single evaluation as a downloadable file.

The evaluation is specified by evaluation_id in the request body. export_format selects CSV, JSON, or JSONL; for CSV the per-item data and files fields are flattened into individual columns and metric-like result columns are expanded. export_method controls delivery: direct returns the file contents inline in the response, while signed_url uploads the file to object storage and returns a pre-signed download URL. Requesting signed_url in an environment where object storage is not configured fails with a 501, so use direct there instead. Set include_archived=true to include archived items in the export. This endpoint reads items only and does not modify the evaluation.

Body ParametersJSONExpand Collapse

evaluation_id: string

The ID of the evaluation to export items from.

export_format: optional ExportFormat

The format of the exported evaluation items. json returns a single JSON array, while jsonl returns one JSON object per line.

One of the following:

"json"

"jsonl"

"csv"

export_method: optional ExportMethod

The method for exporting evaluation items. signed_url returns a pre-signed URL, while direct returns the raw content.

One of the following:

"signed_url"

"direct"

include_archived: optional boolean

If true, include archived evaluation items in the export.

ReturnsExpand Collapse

EvaluationItemExport object { filename, content, signed_url }

Response model for exporting evaluation items. This class represents the response when users export evaluation items. It contains either a signed URL to download the exported data from object storage, or the actual content bytes when direct download is used (in environments where object storage is not configured).

filename: string

The name of the exported file

content: optional string

The raw file content as bytes, used when direct download is enabled

signed_url: optional string

Pre-signed URL to download the file from object storage, if applicable

Export evaluation items to a file

curl https://api.egp.scale.com/v5/evaluation-items/export \
    -H 'Content-Type: application/json' \
    -H "x-api-key: $SGP_API_KEY" \
    -d '{
          "evaluation_id": "evaluation_id"
        }'

{
  "filename": "filename",
  "content": "content",
  "signed_url": "signed_url"
}

Returns Examples

{
  "filename": "filename",
  "content": "content",
  "signed_url": "signed_url"
}