MImistral
files

Retrieve File

Changed on

Returns information about a specific file.

get/v1/files/{file_id}

Request

Path parameters

file_idstring uuid required

Response

OK

idstring uuid required

The unique identifier of the file.

objectstring required

The object type, which is always "file".

bytesinteger required

The size of the file, in bytes.

created_atinteger required

The UNIX timestamp (in seconds) of the event.

filenamestring required

The name of the uploaded file.

purpose'fine-tune' | 'batch' | 'ocr' | 'agentic_safety' required
sample_type'pretrain' | 'instruct' | 'batch_request' | 'batch_result' | 'batch_error' required
num_linesinteger nullable
mimetypestring nullable
source'upload' | 'repository' | 'mistral' required
signaturestring nullable
expires_atinteger nullable
visibility'workspace' | 'user'
deletedboolean required

Example response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f09",
  "object": "file",
  "bytes": 13000,
  "created_at": 1716963433,
  "filename": "files_upload.jsonl"
}

Changes

  • 6c349f3bdef6Revision changes
    • warning

      added the new agentic_safety enum value to the response property for the response status

  • ff8a7389b7a4Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status