Skip to main content
POST
/
api
/
outcomes
Ingest an outcome observation
curl --request POST \
  --url https://app.dacard.ai/api/outcomes \
  --header 'Content-Type: application/json' \
  --cookie __session= \
  --data '
{
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "dimensionId": "<string>",
  "metricName": "deployment_frequency",
  "value": 123,
  "observedAt": "2023-11-07T05:31:56Z",
  "outcomeWindowDays": 30,
  "unit": "deploys/week",
  "baselineObservedAt": "2023-11-07T05:31:56Z",
  "rawJson": "<unknown>"
}
'
{
  "id": "<string>"
}

Authorizations

​
__session
string
cookie
required

Clerk session cookie. Authentication is handled by Clerk. Sign in at https://app.dacard.ai/sign-in to obtain a session.

Body

application/json
​
productId
string<uuid>
required

Product UUID

​
dimensionId
string
required

Dimension ID (e.g. "delivery_velocity")

​
metricName
string
required

Human-readable metric name

Example:

"deployment_frequency"

​
value
number
required

Observed metric value

​
observedAt
string<date-time>
required

When the metric was observed

​
outcomeWindowDays
integer
required

Number of days in the outcome window

Example:

30

​
unit
string

Optional unit label

Example:

"deploys/week"

​
baselineObservedAt
string<date-time>

Optional baseline timestamp for delta calculation

​
rawJson
any

Optional raw payload for audit trail

Response

Outcome observation created

​
id
string

ID of the created observation