Files API
Real world code examples
List Files
Returns a list of files that belong to the user's organization.
200
OK
Test the endpoints live
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.list({});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.list({});
console.log(result);
}
run();
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.list(page=0, page_size=100)
# Handle response
print(res)
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.list(page=0, page_size=100)
# Handle response
print(res)
curl https://api.mistral.ai/v1/files \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/files \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"data": [
{
"id": "<your_file_id>",
"object": "file",
"bytes": null,
"created_at": 1759491994,
"filename": "<your_file_name>",
"purpose": "batch",
"sample_type": "batch_result",
"source": "mistral",
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": null
},
{
"id": "<your_file_id>",
"object": "file",
"bytes": null,
"created_at": 1759491994,
"filename": "<your_file_name>",
"purpose": "batch",
"sample_type": "batch_result",
"source": "mistral",
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": null
}
],
"object": "list",
"total": 2
}{
"data": [
{
"id": "<your_file_id>",
"object": "file",
"bytes": null,
"created_at": 1759491994,
"filename": "<your_file_name>",
"purpose": "batch",
"sample_type": "batch_result",
"source": "mistral",
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": null
},
{
"id": "<your_file_id>",
"object": "file",
"bytes": null,
"created_at": 1759491994,
"filename": "<your_file_name>",
"purpose": "batch",
"sample_type": "batch_result",
"source": "mistral",
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": null
}
],
"object": "list",
"total": 2
}Upload File
Upload a file that can be used across various endpoints.
The size of individual files can be a maximum of 512 MB. The Fine-tuning API only supports .jsonl files.
Please contact us if you need to increase these storage limits.
The File object (not file name) to be uploaded. To upload a file and specify a custom file name you should format your request as such:
file=@path/to/your/file.jsonl;filename=custom_name.jsonlfile=@path/to/your/file.jsonl;filename=custom_name.jsonlOtherwise, you can just keep the original file name:
file=@path/to/your/file.jsonlfile=@path/to/your/file.jsonl200
OK
The size of the file, in bytes.
The UNIX timestamp (in seconds) of the event.
The name of the uploaded file.
The unique identifier of the file.
The object type, which is always "file".
Test the endpoints live
import { Mistral } from "@mistralai/mistralai";
import { openAsBlob } from "node:fs";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.upload({
file: await openAsBlob("example.file"),
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
import { openAsBlob } from "node:fs";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.upload({
file: await openAsBlob("example.file"),
});
console.log(result);
}
run();
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.upload(file={
"file_name": "example.file",
"content": open("example.file", "rb"),
})
# Handle response
print(res)
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.upload(file={
"file_name": "example.file",
"content": open("example.file", "rb"),
})
# Handle response
print(res)
curl https://api.mistral.ai/v1/files \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-d '{
"file": {
"content": "ipsum eiusmod",
"fileName": "consequat do"
}
}'curl https://api.mistral.ai/v1/files \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-d '{
"file": {
"content": "ipsum eiusmod",
"fileName": "consequat do"
}
}'200
{
"id": "e85980c9-409e-4a46-9304-36588f6292b0",
"object": "file",
"bytes": null,
"created_at": 1759500189,
"filename": "example.file.jsonl",
"purpose": "fine-tune",
"sample_type": "instruct",
"source": "upload",
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": "d4821d2de1917341"
}{
"id": "e85980c9-409e-4a46-9304-36588f6292b0",
"object": "file",
"bytes": null,
"created_at": 1759500189,
"filename": "example.file.jsonl",
"purpose": "fine-tune",
"sample_type": "instruct",
"source": "upload",
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": "d4821d2de1917341"
}Retrieve File
Returns information about a specific file.
200
OK
The size of the file, in bytes.
The UNIX timestamp (in seconds) of the event.
The name of the uploaded file.
The unique identifier of the file.
The object type, which is always "file".
Test the endpoints live
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.retrieve({
fileId: "f2a27685-ca4e-4dc2-9f2b-88c422c3e0f6",
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.retrieve({
fileId: "f2a27685-ca4e-4dc2-9f2b-88c422c3e0f6",
});
console.log(result);
}
run();
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.retrieve(file_id="f2a27685-ca4e-4dc2-9f2b-88c422c3e0f6")
# Handle response
print(res)
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.retrieve(file_id="f2a27685-ca4e-4dc2-9f2b-88c422c3e0f6")
# Handle response
print(res)
curl https://api.mistral.ai/v1/files/{file_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/files/{file_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"id": "e85980c9-409e-4a46-9304-36588f6292b0",
"object": "file",
"bytes": null,
"created_at": 1759500189,
"filename": "example.file.jsonl",
"purpose": "fine-tune",
"sample_type": "instruct",
"source": "upload",
"deleted": false,
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": "d4821d2de1917341"
}{
"id": "e85980c9-409e-4a46-9304-36588f6292b0",
"object": "file",
"bytes": null,
"created_at": 1759500189,
"filename": "example.file.jsonl",
"purpose": "fine-tune",
"sample_type": "instruct",
"source": "upload",
"deleted": false,
"num_lines": 2,
"mimetype": "application/jsonl",
"signature": "d4821d2de1917341"
}Delete File
Delete a file.
200
OK
The deletion status.
The ID of the deleted file.
The object type that was deleted
Test the endpoints live
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.delete({
fileId: "3b6d45eb-e30b-416f-8019-f47e2e93d930",
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.delete({
fileId: "3b6d45eb-e30b-416f-8019-f47e2e93d930",
});
console.log(result);
}
run();
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.delete(file_id="3b6d45eb-e30b-416f-8019-f47e2e93d930")
# Handle response
print(res)
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.delete(file_id="3b6d45eb-e30b-416f-8019-f47e2e93d930")
# Handle response
print(res)
curl https://api.mistral.ai/v1/files/{file_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/files/{file_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"id": "e85980c9-409e-4a46-9304-36588f6292b0",
"object": "file",
"deleted": true
}{
"id": "e85980c9-409e-4a46-9304-36588f6292b0",
"object": "file",
"deleted": true
}Download File
Download a file
200
OK
Test the endpoints live
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.download({
fileId: "f8919994-a4a1-46b2-8b5b-06335a4300ce",
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.download({
fileId: "f8919994-a4a1-46b2-8b5b-06335a4300ce",
});
console.log(result);
}
run();
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.download(file_id="f8919994-a4a1-46b2-8b5b-06335a4300ce")
# Handle response
print(res)
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.download(file_id="f8919994-a4a1-46b2-8b5b-06335a4300ce")
# Handle response
print(res)
curl https://api.mistral.ai/v1/files/{file_id}/content \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/files/{file_id}/content \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
"ipsum eiusmod""ipsum eiusmod"Get Signed Url
Number of hours before the url becomes invalid. Defaults to 24h
200
OK
Test the endpoints live
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.getSignedUrl({
fileId: "06a020ab-355c-49a6-b19d-304b7c01699f",
});
console.log(result);
}
run();
import { Mistral } from "@mistralai/mistralai";
const mistral = new Mistral({
apiKey: "MISTRAL_API_KEY",
});
async function run() {
const result = await mistral.files.getSignedUrl({
fileId: "06a020ab-355c-49a6-b19d-304b7c01699f",
});
console.log(result);
}
run();
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.get_signed_url(file_id="06a020ab-355c-49a6-b19d-304b7c01699f", expiry=24)
# Handle response
print(res)
from mistralai import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.files.get_signed_url(file_id="06a020ab-355c-49a6-b19d-304b7c01699f", expiry=24)
# Handle response
print(res)
curl https://api.mistral.ai/v1/files/{file_id}/url \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/files/{file_id}/url \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"url": "https://mistralaifilesapiprodswe.blob.core.windows.net/fine-tune/.../.../e85980c9409e4a46930436588f6292b0.jsonl?se=2025-10-04T14%3A16%3A17Z&sp=r&sv=2025-01-05&sr=b&sig=..."
}{
"url": "https://mistralaifilesapiprodswe.blob.core.windows.net/fine-tune/.../.../e85980c9409e4a46930436588f6292b0.jsonl?se=2025-10-04T14%3A16%3A17Z&sp=r&sv=2025-01-05&sr=b&sig=..."
}