Skip to content
Sursa Developers

Objects

TextCardRequest

Fields

  • titlestringrequired

    length ≥ 1, length ≤ 200

  • collectionstring

    Default: "default"

  • body_markdownstring

    Card text in Markdown; content_type does not apply to it. You can pass body instead.

    length ≥ 1, length ≤ 500000

  • tagsarray of string | null

    items ≤ 30

  • categorystring | null

    length ≤ 60

  • sensitiveboolean | null
  • owner_idinteger | null
  • asyncboolean

    Default: false

  • bodystring

    Card text in the content_type format. Pass either body or body_markdown; passing both returns 422 validation.failed.

    length ≥ 1, length ≤ 500000

  • collection_idinteger | null

    Collection by ID. When collection is passed too, collection_id wins. A collection that does not exist in the organization or is not visible returns 404 collections.not_found.

  • folder_idstring | null

    Folder of the collection to put the card in, with the same checks as folder_id of a file upload. A folder of another collection returns 400 folders.card_collection_mismatch, a missing folder returns 404 folders.not_found, and no COLLECTION_EDIT_CARDS permission on the folder returns 403 authz.forbidden.

    length ≤ 64

  • external_idstring | null

    external_id of the new card. If another card of the organization uses it, the request returns 409 cards.external_id_taken. To create or replace a card by external_id, use PUT /v1/cards-by-external-id/{external_id}.

    length ≤ 512

Used by