Объекты

CardUploadForm

Поля

• filestring (application/octet-stream)обязательно
• collectionstring

  По умолчанию: "default"

• tagsstring

  По умолчанию: ""

• forceboolean

  По умолчанию: false

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

  По умолчанию: 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_found.

• external_idstring | null

  external_id новой карточки. С ним карточка создаётся, даже если в коллекции уже есть такой же файл. Если его использует другая карточка организации, запрос возвращает 409 cards.external_id_taken. Чтобы создать или заменить карточку по external_id, используйте PUT /v1/cards-by-external-id/{external_id}.

  length ≤ 512

• metadatastring | null

  metadata новой карточки: объект JSON как значение поля формы. Правила — как у MetadataPatch.

Используется в

• POST/v1/cardsЗагрузить файл как карточку