POST/api/v1/health/score/async

Submit Async Health Score Job

Submit asynchronous health score calculation job for large schedules.

This endpoint queues a job for background processing and returns immediately with a job ID. Use the job status endpoint to poll for completion.

Use Cases:

Performance:

Tier Limits:

Webhook Delivery:

Source: same score as POST /api/v1/health/score. The weights are not a cited standard.

Request example

json

{
  "tasks": [
    {
      "id": "T1",
      "duration_days": 5
    }
  ]
}

Required fields and the optional fields that change this call are listed here. The shared task model stays on the task schema guide.

This table is generated from the endpoint schema in openapi.json.

Field	Type	Required	Description
tasks	array<object>	Required	List of tasks (same format as synchronous endpoint)
callback_url	string \| null	Optional	Webhook URL for result delivery (optional)
priority	string	Optional	Priority level for async jobs. Priority levels affect queue position: - HIGH: Critical jobs, processed first - NORMAL: Standard processing priority - LOW: Background jobs, processed when resources available
include_details	boolean	Optional	Include detailed task-level diagnostics and recommendations

json

{
  "score": 92,
  "grade": "A"
}

This table is generated from the endpoint response schema in openapi.json.

Field	Type	Required	Description
type	string	Required	Documentation URL for the code: https://bellatorsi.com/problems/<slug>.
title	string	Required	Short summary of the problem type.
status	integer	Required	HTTP status code.
detail	string	Required	What went wrong in this request.
code	string	Required	Stable UPPER_SNAKE machine code.

json-schema

{
  "$ref": "#/components/schemas/ProblemDetails"
}

Operation ID: health_score_async
Section: Health
Tags: Health
Playground link: /playground?endpoint=%2Fapi%2Fv1%2Fhealth%2Fscore%2Fasync&method=post

Was this page helpful?

Your feedback helps us improve docs, reference pages, and Playground flows.

Topic: Submit Async Health Score Job · Page: /docs/api-reference/health_score_async

Schedule analysis guidance. Not legal advice. You remain responsible for contract and agency compliance.