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

# Task
An initiative task assigned to an entity. A task is associated with a scorecard check, an initiative, and an entity check issue in a third-party task management system (Jira or Linear).

## Example

```json
{
  "check": {
    "id": "has-tests",
    "name": "Has Unit Tests",
    "description": "Service has comprehensive unit test coverage",
    "external_url": "https://docs.company.com/testing-guide"
  },
  "entity_check_issue": {
    "id": "PROJ-123",
    "url": "https://company.atlassian.net/browse/PROJ-123"
  },
  "initiative": {
    "id": "q1-quality",
    "name": "Q1 Quality Initiative",
    "description": "Improve code quality across all services",
    "complete_by": "2024-03-31",
    "priority": "1"
  },
  "owner": {
    "id": 42,
    "name": "Jane Smith",
    "email": "jane.smith@company.com",
    "avatar": "https://avatars.company.com/jane.smith.png",
    "slack_ext_id": "U01234567"
  }
}
```

## Properties

| Key                  | Type                                                            | Description                                                                                                             |
| -------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `check`              | [Check](https://docs.getdx.com/webapi/types/check/)                                   | The check to which the task is associated.                                                                              |
| `entity_check_issue` | [Entity Check Issue](https://docs.getdx.com/webapi/types/entity-check-issue/) \| null | The third-party issue in a task management tool (Jira, Linear, etc.) linking back to this task, if it has been created. |
| `initiative`         | [Initiative](https://docs.getdx.com/webapi/types/initiative/)                         | The initiative to which the task is associated.                                                                         |
| `owner`              | [Task Owner](https://docs.getdx.com/webapi/types/task-owner/)                         | The user that created the initiative to which the task is associated.                                                   |
---

## Sitemap

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