Mention file type during attachment upload (#682)

mozilla · Oct 18, 2024 · 200bba9 · 200bba9
1 parent 11b2675
commit 200bba9
Showing 1 changed file with 5 additions and 3 deletions.
diff --git a/docs/tutorial-attachments.rst b/docs/tutorial-attachments.rst
@@ -50,18 +50,20 @@ Suppose that we want to attach a file (``/home/mathieu/DAFSA.bin``) to the exist
 
     curl -X POST ${SERVER}/buckets/${BUCKET}/collections/${COLLECTION}/records/${RECORD}/attachment \
          -H 'Content-Type:multipart/form-data' \
-         -F attachment=@$FILEPATH \
+         -F attachment=@$FILEPATH;type=application/vnd.dafsa \
          -u user:pass
 
-And in order to create a record with both attributes and attachment, you'll have a generate a record id yourself.
+If not specified, the file type of the uploaded attachment is determined from the file extension, with ``application/octet-stream`` by default (see *CDN compression* below).
+
+And in order to create a new record with both attributes and attachment, you'll have a generate a record id yourself.
 
 .. code-block:: bash
 
     RECORD_ID=`uuidgen`
 
     curl -X POST ${SERVER}/buckets/${BUCKET}/collections/${COLLECTION}/records/${RECORD_ID}/attachment \
          -H 'Content-Type:multipart/form-data' \
-         -F attachment=@$FILEPATH \
+         -F attachment=@$FILEPATH;type=application/vnd.dafsa \
          -F 'data={"name": "Mac Fly", "age": 42}' \
          -u user:pass