Skip to Content
DocumentationAPI ReferenceLinks

Links API

POST /api/workspace/links
Authorization: Bearer TOKEN
Content-Type: application/json

Request Body

FieldTypeRequiredDescription
source_idstringYesID of the source note
target_idstringYesID of the target note
relationstringYesOne of: relates_to, extends, contradicts, depends_on, supersedes, derived_from

Relation Types

RelationDirectionMeaning
relates_toBidirectionalGeneral connection
extendsSource extends targetBuilds upon
contradictsSource contradicts targetChallenges or disagrees
depends_onSource depends on targetPrerequisite
supersedesSource replaces targetNewer, better version
derived_fromSource derived from targetSynthesized from

Example

curl -X POST https://api.cortex-app.dev/api/workspace/links \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "note_a1b2c3d4",
    "target_id": "note_e5f6g7h8",
    "relation": "extends"
  }'

Response 201

{
  "source_id": "note_a1b2c3d4",
  "target_id": "note_e5f6g7h8",
  "relation": "extends",
  "created_at": "2025-03-10T14:35:00Z"
}
Last updated on
NotesRecall