Back to changelog

Uploaded Files Keep Their Names

An uploaded file is now listed under the name you sent.

Before, the name came back changed. A file uploaded as meeting notes (final).txt was listed as 1795225211305-meeting%20notes%20%28final%29.txt: a timestamp in front, and spaces and parentheses percent-encoded. Now the same file is listed as meeting notes (final).txt.

This applies to filename in List Documents, Get Document and search results, and to files[].uri in an indexing job. It applies to files that are already indexed, not only new uploads.

Do I need to change anything?

  • If you percent-decode the listed name and strip the timestamp, as the guide suggested: remove that step. Compare the listed name with your filename as it is. Left in place, the step now damages some real names: 2024-report.txt loses its 2024-, and a file really named notes%20final.txt is decoded to a different name.
  • If you saved the old name and compare it exactly: it no longer matches. Compare with the name you uploaded.

What stays the same

  • Only files sent through Index File and Index Text change. Files indexed from a bucket keep their names.
  • A document's uri field, in List Documents and Get Document, still shows where the file is stored, and that location still has the timestamp in front of the name. A job's files[].uri is different: it is now the uploaded name.
  • The filename is still what makes two uploads the same document. Upload the same name again and it is the same document. Two files sent with the same filename in one request are two documents, and both are listed under that filename.

Same day: Word Files Return Plain Text