ออบเจ็กต์
CardUploadForm
ฟิลด์
filestring (application/octet-stream)จำเป็นcollectionstringค่าเริ่มต้น: "default"
tagsstringค่าเริ่มต้น: ""
forcebooleanค่าเริ่มต้น: false
owner_idinteger | nullverify_interval_daysinteger | nullcategorystring | nullsensitiveboolean | nullasyncbooleanค่าเริ่มต้น: false
reviewbooleanค่าเริ่มต้น: false
folder_idstring | nullโฟลเดอร์ของ
collectionที่จะใส่การ์ดใหม่ ถ้าเป็นโฟลเดอร์ของคอลเลกชันอื่นจะได้รับ400 folders.card_collection_mismatchถ้าไม่มีโฟลเดอร์นั้นจะได้รับ404 folders.not_foundและถ้าไม่มีสิทธิ์COLLECTION_EDIT_CARDSบนโฟลเดอร์จะได้รับ403 authz.forbiddenระบบตรวจก่อนบันทึกไฟล์ ถ้าไฟล์ซ้ำกับไฟล์ที่อัปโหลดไว้แล้ว (skipped) ระบบจะไม่ย้ายไฟล์นั้นเข้าโฟลเดอร์length ≤ 64
collection_idinteger | nullคอลเลกชันตาม ID เมื่อส่ง
collectionมาด้วย ระบบใช้collection_idถ้าคอลเลกชันไม่มีอยู่ในองค์กรหรือมองไม่เห็นจะได้รับ404 collections.not_foundexternal_idstring | nullexternal_idของการ์ดใหม่ เมื่อระบุค่านี้ ระบบจะสร้างการ์ดแม้คอลเลกชันมีไฟล์เดียวกันอยู่แล้ว ถ้าการ์ดอื่นขององค์กรใช้ค่านี้อยู่ คำขอจะได้รับ409 cards.external_id_takenหากต้องการสร้างหรือแทนที่การ์ดตามexternal_idให้ใช้PUT /v1/cards-by-external-id/{external_id}length ≤ 512
metadatastring | nullmetadataของการ์ดใหม่: ออบเจ็กต์ JSON เป็นค่าของฟิลด์ในฟอร์ม กฎเหมือนกับของMetadataPatch