Chuyển tới nội dung
Sursa Developers

Đối tượng

TextCardRequest

Trường

  • titlestringbắt buộc

    length ≥ 1, length ≤ 200

  • collectionstring

    Mặc định: "default"

  • body_markdownstring

    Nội dung thẻ bằng Markdown; content_type không áp dụng cho trường này. Bạn có thể truyền body thay thế.

    length ≥ 1, length ≤ 500000

  • tagsarray of string | null

    items ≤ 30

  • categorystring | null

    length ≤ 60

  • sensitiveboolean | null
  • owner_idinteger | null
  • asyncboolean

    Mặc định: false

  • bodystring

    Nội dung thẻ theo định dạng content_type. Truyền body hoặc body_markdown; truyền cả hai sẽ trả về 422 validation.failed.

    length ≥ 1, length ≤ 500000

  • content_typeCardTextContentType
  • collection_idinteger | null

    Bộ sưu tập theo ID. Khi collection cũng được truyền, collection_id được ưu tiên. Bộ sưu tập không tồn tại trong tổ chức hoặc không hiển thị với bạn trả về 404 collections.not_found.

  • folder_idstring | null

    Thư mục của bộ sưu tập để đặt thẻ vào, với cùng các bước kiểm tra như folder_id khi tải tệp lên. Thư mục của bộ sưu tập khác trả về 400 folders.card_collection_mismatch, thư mục không tồn tại trả về 404 folders.not_found, còn khi không có quyền COLLECTION_EDIT_CARDS trên thư mục thì trả về 403 authz.forbidden.

    length ≤ 64

  • external_idstring | null

    external_id của thẻ mới. Nếu một thẻ khác của tổ chức đang dùng giá trị này, yêu cầu trả về 409 cards.external_id_taken. Để tạo hoặc thay thế thẻ theo external_id, hãy dùng PUT /v1/cards-by-external-id/{external_id}.

    length ≤ 512

  • metadataMetadataPatch

Được dùng trong