Objets

CardUploadForm

Champs

• filestring (application/octet-stream)obligatoire
• collectionstring

  Par défaut : "default"

• tagsstring

  Par défaut : ""

• forceboolean

  Par défaut : false

• owner_idinteger | null
• verify_interval_daysinteger | null
• categorystring | null
• sensitiveboolean | null
• asyncboolean

  Par défaut : false

• reviewboolean

  Par défaut : false

• folder_idstring | null

  Dossier de la collection collection où placer la nouvelle fiche. Un dossier d’une autre collection renvoie 400 folders.card_collection_mismatch, un dossier inexistant renvoie 404 folders.not_found, et l’absence de la permission COLLECTION_EDIT_CARDS sur le dossier renvoie 403 authz.forbidden. La vérification a lieu avant l’enregistrement du fichier. Le doublon d’un fichier déjà téléversé (skipped) n’est pas déplacé dans le dossier.

  length ≤ 64

• collection_idinteger | null

  Collection par ID. Si collection est aussi transmis, collection_id l’emporte. Une collection qui n’existe pas dans l’organisation ou qui n’est pas visible renvoie 404 collections.not_found.

• external_idstring | null

  external_id de la nouvelle fiche. Avec lui, la fiche est créée même si la collection contient déjà le même fichier. Si une autre fiche de l’organisation l’utilise, la requête renvoie 409 cards.external_id_taken. Pour créer ou remplacer une fiche par external_id, utilisez PUT /v1/cards-by-external-id/{external_id}.

  length ≤ 512

• metadatastring | null

  metadata de la nouvelle fiche : un objet JSON comme valeur du champ de formulaire. Les règles sont celles de MetadataPatch.

Utilisé par

• POST/v1/cardsTéléverser un fichier comme fiche