Link a work item

Attach an external work item (Linear, GitHub, or a URL) to a recommendation. Linking is idempotent by normalized URL: re-linking an already-linked URL updates its title and externalId in place instead of adding a duplicate. A recommendation holds at most 20 work items; linking a new URL past that cap fails with a 409.

POST/v1/recommendations/{recommendationId}/work-items

Example

curl -X POST "https://silent-viper-157.convex.site/v1/recommendations/rec_456/work-items" \  -H "Authorization: Bearer $ASKENGINE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "url": "https://linear.app/acme/issue/ACM-412",    "title": "First-run setup checklist",    "externalId": "ACM-412"  }'

Request Body

urlstring

The work item URL. Must be http(s); other schemes are rejected.

title?string

Display title for the work item.

externalId?string

The tracker's own id for the work item (e.g. ENG-123).

Response

{  "data": {    "recommendationId": "rec_456"  }}