Create card

Content and title are required. Card share status should be set to TEAM to make a card team shared. Omitting the share status value or setting it to PRIVATE will result in a card that is only accessible by the card owner. This endpoint allows the verifier to be set upon card creation, rather than requiring a separate call.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Card data

Card model with additional properties for use when creating cards

folderIds
array of strings

One or more folder IDs to which the new card should be added on creation

folderIds
permissions
array of strings
permissions
string

ID of the Card

string
required

The Card's HTML or Markdown content

owner
object
string
enum

Whether the card is TRUSTED, STALE, or NEEDS_VERIFICATION

Allowed:
lastModifiedBy
object
lastVerifiedBy
object
tags
array of objects, unique

Returns Tag objects associated with this card

tags
collection
object
date-time

Date the Card was last verified

string
required

The title of the Card

boards
array of objects, unique

Returns Board objects that this card appears on

boards
string
enum

The share status of the Card. TEAM for team shared cards and PRIVATE for privately shared cards

Allowed:
boolean

Flag for enabling card verification on save

int32

Time interval (in days), indicating the frequency that this card needs re-verification. Passing in null will default to 30 days.

verifiers
array of objects

Users/Groups that are responsible for verifying this card

verifiers
string
enum

Whether the card's verification date is ABSOLUTE or RELATIVE

Allowed:
collaborators
array of objects

Users/Groups that this card is explicitly shared to. Collaborators of a card are the only ones who have access if the Card's shareStatus is PRIVATE.

collaborators
string
enum
Allowed:
string
date-time
double
boolean
date-time

Next date that this Card needs verification dependent on verification interval

originalOwner
object
attachments
array of objects

Attachments to the card

attachments
verificationReasons
array of strings
verificationReasons
Allowed:
verificationInitiator
object
cardInfo
object
syncInfo
object
date-time

Date corresponding to the action that unverified the card

string
boolean

A flag to indicate if the changes are only updating the settings of the card

boolean
Responses

400

Invalid/Incomplete request. Content and title are required

401

Request was unauthorized

403

Forbidden access to the resource

404

Resource could not be found

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json