Skip to main content
POST
/
v1
/
cards
/
{cardId}
/
metrics
/
bulk
Submit bulk metrics for a card
curl --request POST \
  --url https://api.vistaly.com/v1/cards/{cardId}/metrics/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metrics": [
    {
      "value": 123,
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}
'
{
  "message": "Bulk metric import completed",
  "succeeded": 950,
  "failed": [
    {
      "index": 42,
      "metric": {
        "value": -1,
        "timestamp": "2024-01-01T00:00:00Z"
      },
      "error": "Unknown error occurred"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
cardId
string
required

The unique identifier for the card whose metrics are being submitted.

Body

application/json
​
metrics
object[]
required

Array of metric datapoints to be created

Required array length: 1 - 1000 elements

Response

Bulk metrics import completed (may include partial failures)

​
message
string
required
​
succeeded
integer
required

Number of metric datapoints successfully created

​
failed
object[]
required

Details of metric datapoints that failed to create