---
title: "Initiative"
canonical_url: "https://docs.getdx.com/webapi/types/initiative/"
md_url: "https://docs.getdx.com/webapi/types/initiative.md"
last_updated: "2026-05-08"
---

# Initiative
Represents a DX initiative connected to a scorecard and a set of required checks, to complete by a deadline.

## Example

```json
{
  "id": "security-hardening",
  "name": "Security Hardening Initiative",
  "description": "Implement security best practices across all services. This includes adding authentication, authorization, and security scanning.",
  "complete_by": "2024-06-30",
  "priority": "0"
}
```

## Properties

| Key           | Type   | Description                                                        |
| ------------- | ------ | ------------------------------------------------------------------ |
| `id`          | string | The initiative's unique ID.                                        |
| `complete_by` | string | The initiative's due date.                                         |
| `description` | string | The initiative's description. Markdown will be rendered in the UI. |
| `name`        | string | The initiative's name.                                             |
| `priority`    | string | The initiative's priority level. Must be 0, 1, or 2.               |
---

## Sitemap

[Overview of all docs pages](/llms.txt)
