Oggetti

CardUploadForm

Campi

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

  Predefinito: "default"

• tagsstring

  Predefinito: ""

• forceboolean

  Predefinito: false

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

  Predefinito: false

• reviewboolean

  Predefinito: false

• folder_idstring | null

  Cartella della collection in cui mettere la nuova scheda. Una cartella di un’altra raccolta restituisce 400 folders.card_collection_mismatch, una cartella inesistente restituisce 404 folders.not_found, e l’assenza del permesso COLLECTION_EDIT_CARDS sulla cartella restituisce 403 authz.forbidden. Il controllo avviene prima che il file venga salvato. Un duplicato di un file già caricato (skipped) non viene spostato nella cartella.

  length ≤ 64

• collection_idinteger | null

  Raccolta per ID. Quando viene passato anche collection, prevale collection_id. Una raccolta che non esiste nell’organizzazione o non è visibile restituisce 404 collections.not_found.

• external_idstring | null

  external_id della nuova scheda. Con questo campo la scheda viene creata anche se la raccolta contiene già lo stesso file. Se un’altra scheda dell’organizzazione lo usa, la richiesta restituisce 409 cards.external_id_taken. Per creare o sostituire una scheda tramite external_id, usa PUT /v1/cards-by-external-id/{external_id}.

  length ≤ 512

• metadatastring | null

  metadata della nuova scheda: un oggetto JSON come valore del campo del modulo. Le regole sono quelle di MetadataPatch.

Usato da

• POST/v1/cardsCaricare un file come scheda