Skip to main content

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 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.
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"]
  }'
PropertyValue
AuthRequired
Required integrationLinear (with dac-backlog/destination set to linear)
IdempotentNo (each call creates a new Linear issue)

Body

FieldTypeRequiredNotes
artifactTyperecommendation | move | board_reportyesWhat’s being pushed.
artifactIdstringyesThe Dacard id.
labelIdsstring[]noLinear label ids to apply.

Response

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

Errors

StatusCodeWhen
401AUTH_REQUIREDNo session.
401INTEGRATION_DISCONNECTLinear OAuth expired.
403FORBIDDENCaller does not own the artifact.
404Artifact not foundBad artifactId.
500INTERNAL_ERRORLinear API call or write failed.