> ## 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.  |