> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Push to Linear

> Push a DAC artifact (move, recommendation, board read) to the configured Linear team as an issue.

Push a DAC artifact (move, recommendation, board read) to the configured Linear team as an issue. The Linear integration must be connected and the dac-backlog destination must be set to `linear`.

```bash theme={null}
curl -X POST https://app.dacard.ai/api/integrations/linear/push \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "artifactType": "recommendation",
    "artifactId": "rec_xyz",
    "labelIds": ["lbl_dac_coaching"]
  }'
```

| Property | Value |
| - | - |
| **Auth** | Required |
| **Required integration** | Linear (with `dac-backlog/destination` set to `linear`) |
| **Idempotent** | No (each call creates a new Linear issue) |

## Body

| Field | Type | Required | Notes |
| - | - | - | - |
| `artifactType` | `recommendation` \| `move` \| `board_report` | yes | What's being pushed. |
| `artifactId` | string | yes | The Dacard id. |
| `labelIds` | string\[] | no | Linear label ids to apply. |

## Response

```json theme={null}
{
  "linearIssue": {
    "id": "lin_abc",
    "url": "https://linear.app/acme/issue/ENG-1234",
    "identifier": "ENG-1234"
  }
}
```

## Errors

| Status | Code | When |
| - | - | - |
| 401 | `AUTH_REQUIRED` | No session. |
| 401 | `INTEGRATION_DISCONNECT` | Linear OAuth expired. |
| 403 | `FORBIDDEN` | Caller does not own the artifact. |
| 404 | `Artifact not found` | Bad `artifactId`. |
| 500 | `INTERNAL_ERROR` | Linear API call or write failed. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.