Create a health recompute request

POST

/v1/dataset-versions/{versionId}/health-recompute-requests

curl -X POST 'https://api.embodiflow.io/v1/dataset-versions/{versionId}/health-recompute-requests' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Path parameters

versionIdstringrequired

Header parameters

Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Responses

Success

dataobjectrequired
- idstringrequired
- datasetVersionIdstringrequired
- statusstringrequired
  Allowed values
  completed
  deduplicated
- deduplicatedone ofrequired
- healthobjectrequired
- createdAtstringrequired

Response example

{
  "data": {
    "id": "string",
    "datasetVersionId": "string",
    "status": "completed",
    "deduplicated": false,
    "health": {
      "datasetVersionId": "string",
      "datasetId": "string",
      "projectId": "string",
      "status": "unknown",
      "score": 0,
      "dimensions": [
        {
          "id": "quality",
          "status": "warning",
          "message": "string",
          "recommendedAction": "string",
          "evidenceLinks": [
            {}
          ]
        }
      ],
      "blockers": [
        {
          "id": "string",
          "dimensionId": "quality",
          "severity": "warning",
          "code": "string",
          "message": "string",
          "waived": false,
          "waiveReason": "string",
          "waivedAt": "string",
          "waivedByDisplayName": "string",
          "waiverNeedsReview": false,
          "evidenceLinks": [
            {}
          ],
          "linkedRepairTaskId": "string",
          "linkedRepairTaskStatus": "in_progress"
        }
      ],
      "recommendedNextAction": "string",
      "computedAt": "string",
      "freshnessStatus": "unknown",
      "evidenceUpdatedAt": "string",
      "isStale": false,
      "staleReason": "string",
      "recomputeStatus": "in_progress",
      "assetHealthStatus": "failed"
    },
    "createdAt": "string"
  }
}

Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1

{ "data": { "id": "string", "datasetVersionId": "string", "status": "completed", "deduplicated": false, "health": { "datasetVersionId": "string", "datasetId": "string", "projectId": "string", "status": "unknown", "score": 0, "dimensions": [ { "id": "quality", "status": "warning", "message": "string", "recommendedAction": "string", "evidenceLinks": [ {} ] } ], "blockers": [ { "id": "string", "dimensionId": "quality", "severity": "warning", "code": "string", "message": "string", "waived": false, "waiveReason": "string", "waivedAt": "string", "waivedByDisplayName": "string", "waiverNeedsReview": false, "evidenceLinks": [ {} ], "linkedRepairTaskId": "string", "linkedRepairTaskStatus": "in_progress" } ], "recommendedNextAction": "string", "computedAt": "string", "freshnessStatus": "unknown", "evidenceUpdatedAt": "string", "isStale": false, "staleReason": "string", "recomputeStatus": "in_progress", "assetHealthStatus": "failed" }, "createdAt": "string" } }