Skip to main content
POST
/
v1
/
notes
/
search-references
Search referenceable entities for mentions
curl --request POST \
  --url https://api.linda.cedarai.com/v1/notes/search-references \
  --header 'Carrier: <carrier>' \
  --header 'Content-Type: application/json' \
  --header 'x-arms-api-key: <api-key>' \
  --header 'x-arms-assume-user: <api-key>' \
  --data '
{
  "entity_types": [
    "<string>"
  ],
  "limit": 123,
  "query": "<string>"
}
'
{
  "results": [
    {
      "display_text": "<string>",
      "entity_id": "<string>",
      "entity_type": "<string>",
      "score": 123,
      "subtitle": "<string>",
      "url": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.cedarai.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-arms-api-key
string
header
required
x-arms-assume-user
string
header
required

Headers

Carrier
string
required

Carrier ID the request is scoped to.

Body

application/json

Request for the @-mention typeahead. Searches across configured entity types in parallel and returns the top N matches per type. Use the result fields to construct the inline <<ref:...>> token in your note's content and the matching NoteReference entry in references.

Request for the @-mention typeahead. Searches across configured entity types in parallel and returns the top N matches per type. Use the result fields to construct the inline <<ref:...>> token in your note's content and the matching NoteReference entry in references.

entity_types
string[]

Restrict to specific entity types. Empty array searches every searchable type. Pass e.g. ["equipment", "shipment"] to scope.

limit
integer<int64>

Per-type result cap. Defaults to 5.

query
string

Free-text query — typically the characters typed after @ in the editor (e.g. BNSF 543, acme, WB-1842).

Response

A successful response.

results
object[]

Top matches across all (or the requested) entity types. Per-type results are flattened and sorted by score; clients typically re-group by entity_type for display.