Note Object Links

Notes can be linked to other Monolith objects — evidence items, tasks, timeline events, acquisitions, or the case itself. Links make a note discoverable from the linked object (and vice versa: GET /v1/notes?object_id=...).

Supported object_type values: timeline_event, task, case, evidence, acquisition.

Endpoints

• GET /v1/notes/object-links — list links

• POST /v1/notes/object-links — create a link

• DELETE /v1/notes/object-links/{id} or DELETE /v1/notes/object-links?note_uuid=...&object_id=... — delete a link

---

List object links

GET /v1/notes/object-links

Query parameters

All optional.

Parameter	Type	Default	Description
id	number	—	A single link by its numeric id.
note_uuid	string	—	Links belonging to this note.
object_id	string	—	Links pointing at this object.
object_type	string	—	Filter by object type.
page	number	1	Page number (1-based).
page_size	number	3000	Results per page, max 3000.

Response — 200 OK

{
  "data": [
    {
      "id": 314,
      "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "object_id": "e7c40f6e-2f19-4b52-9d7a-52a5a24c3f10",
      "object_type": "evidence",
      "object_name": "EV-2026-0042-001",
      "created_on": "2026-08-03T14:25:00Z"
    }
  ],
  "page": 1,
  "next_page": null,
  "page_size": 3000,
  "total": 1
}

object_name is the human-readable name of the linked object (evidence number, task name, ...), resolved at read time. It is null if the target object no longer exists.

response = session.get(f"{BASE_URL}/notes/object-links", params={
    "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
})
for link in response.json()["data"]:
    print(f"[{link['id']}] {link['object_type']}: {link['object_name']}")

---

Create an object link

POST /v1/notes/object-links
Content-Type: application/json

Request body

Field	Type	Required	Description
note_uuid	string	yes	UUID of the note.
object_id	string	yes	UUID of the target object.
object_type	string	yes	timeline_event, task, case, evidence, or acquisition.

{
  "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
  "object_id": "e7c40f6e-2f19-4b52-9d7a-52a5a24c3f10",
  "object_type": "evidence"
}

Response — 201 Created (or 200 OK if the link already existed)

Creating a link that already exists is not an error: the call succeeds with status 200 and "created": false.

{
  "success": true,
  "created": true,
  "message": "Note object link created",
  "data": {
    "id": 314,
    "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "object_id": "e7c40f6e-2f19-4b52-9d7a-52a5a24c3f10",
    "object_type": "evidence",
    "object_name": "EV-2026-0042-001",
    "created_on": "2026-08-03T14:25:00Z"
  }
}

response = session.post(f"{BASE_URL}/notes/object-links", json={
    "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "object_id": "e7c40f6e-2f19-4b52-9d7a-52a5a24c3f10",
    "object_type": "evidence",
})
body = response.json()
if body["created"]:
    print(f"Linked (link id {body['data']['id']})")
else:
    print("Was already linked")

---

Delete an object link

Target a single link by its numeric id, or by the note + object pair. Deleting by note alone is intentionally not supported — that would silently remove every link the note has.

DELETE /v1/notes/object-links/{id}
DELETE /v1/notes/object-links?note_uuid={note_uuid}&object_id={object_id}

Response — 200 OK

{
  "success": true,
  "message": "Note object link deleted",
  "deleted_count": 1
}

# By link id
session.delete(f"{BASE_URL}/notes/object-links/314").raise_for_status()

# By note + object pair
session.delete(f"{BASE_URL}/notes/object-links", params={
    "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "object_id": "e7c40f6e-2f19-4b52-9d7a-52a5a24c3f10",
}).raise_for_status()

---

Errors

Status	Body	Cause
400	{"message": "Invalid request body", "errors": [...]}	Missing field or invalid object_type on create.
400	{"message": "Invalid request parameters", "errors": [...]}	Delete without an id or a note_uuid + object_id pair.
404	{"message": "Note not found"}	Create targeting a nonexistent note.
404	{"message": "Note object link not found"}	Delete targeting a nonexistent link.
401	Unauthorized	Missing or invalid API key.