Download Evaluation Files

Download rubric or answer files attached to an evaluation by field name and index.

GET /v1/platform/evaluations/:id/files/:field/:index

Downloads a file attached to an evaluation. Files uploaded as part of rubric-based or file-based evaluations can be retrieved individually by field name and index.

Path Parameters

ParameterTypeDescription
idstringThe evaluation request ID (UUID)
fieldstringThe file field name. One of rubricFiles or answerFiles.
indexintegerThe 0-based index of the file within the specified field

Authentication

Requires a Platform API Key passed via the Authorization header.

Response

Returns the file as a binary download. The response includes a Content-Disposition header with the original filename.

HeaderExample
Content-Dispositionattachment; filename="rubric.pdf"
Content-TypeMatches the original file MIME type

Example Request

Download the first rubric file:

curl https://api.tutorflow.io/v1/platform/evaluations/2f4ad455-1e8e-4b6c-9f3a-7ebf4cf6f483/files/rubricFiles/0 \
  -H "Authorization: Bearer tf_platform_..." \
  -o rubric.pdf

Download the second answer file:

curl https://api.tutorflow.io/v1/platform/evaluations/2f4ad455-1e8e-4b6c-9f3a-7ebf4cf6f483/files/answerFiles/1 \
  -H "Authorization: Bearer tf_platform_..." \
  -o answer-page-2.pdf

Error Responses

StatusDescription
404Evaluation not found, invalid field name, or file index out of range
401Missing or invalid API key