Objetos

CardUploadForm

Campos

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

  Predeterminado: "default"

• tagsstring

  Predeterminado: ""

• forceboolean

  Predeterminado: false

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

  Predeterminado: false

• reviewboolean

  Predeterminado: false

• folder_idstring | null

  Carpeta de collection en la que se coloca la tarjeta nueva. Una carpeta de otra colección devuelve 400 folders.card_collection_mismatch, una carpeta inexistente devuelve 404 folders.not_found, y la falta del permiso COLLECTION_EDIT_CARDS sobre la carpeta devuelve 403 authz.forbidden. La comprobación se hace antes de guardar el archivo. Un duplicado de un archivo ya subido (skipped) no se mueve a la carpeta.

  length ≤ 64

• collection_idinteger | null

  Colección por ID. Cuando también se envía collection, prevalece collection_id. Una colección que no existe en la organización o no es visible devuelve 404 collections.not_found.

• external_idstring | null

  external_id de la tarjeta nueva. Con él, la tarjeta se crea aunque la colección ya tenga el mismo archivo. Si otra tarjeta de la organización lo usa, la solicitud devuelve 409 cards.external_id_taken. Para crear o sustituir una tarjeta por external_id, use PUT /v1/cards-by-external-id/{external_id}.

  length ≤ 512

• metadatastring | null

  metadata de la tarjeta nueva: un objeto JSON como valor del campo del formulario. Las reglas son las de MetadataPatch.

Se usa en

• POST/v1/cardsSubir un archivo como tarjeta