Skip to main content
POST
/
beta
/
cards
Create a new card
curl --request POST \
  --url https://api.vistaly.com/beta/cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardTitle": "Improve customer onboarding",
  "parentId": "<string>",
  "parentType": "backlog",
  "cardDetails": "We need to streamline the onboarding process to reduce drop-off rates",
  "cardStatus": "now",
  "cardType": "assumption",
  "resources": [
    {
      "url": "<string>",
      "title": "<string>"
    }
  ]
}
'
{
  "cardId": "<string>",
  "cardUrl": "<string>",
  "message": "Card created successfully"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
cardTitle
string
required

The title of the card

Example:

"Improve customer onboarding"

​
parentId
string
required

The ID of the parent to associate this card

​
parentType
enum<string>
required

The type of the parent

Available options:
backlog,
card
​
cardDetails
string

The detailed description of the card

Example:

"We need to streamline the onboarding process to reduce drop-off rates"

​
cardStatus
enum<string>

The initial status of the card. The status value must be valid for the card type.

Available options:
addressed,
at risk,
developing,
done,
failed,
idea,
identified,
later,
next,
not now,
now,
passed,
pending,
progressing,
running,
on track,
uncommitted
Example:

"now"

​
cardType
enum<string>
Available options:
assumption,
experiment,
kpi,
objective,
opportunity,
outcome,
problem,
product,
solution
​
resources
object[]

List of resource links associated with this card

Response

Card created successfully

​
cardId
string
required

The unique identifier of the created card

​
cardUrl
string
required

The url of the created card

​
message
string
required

Success message

Example:

"Card created successfully"