Skip to main content

​
List Edges

Returns edges (relationships) connected to the specified entity IDs. Use IDs obtained from /graph/entities.

​
Request

GET /api/v1/graph/edges?entityIds=id1,id2,id3

​
Headers

HeaderRequiredDescription
AuthorizationYesAPI key in Bearer snorbe_... format

​
Query Parameters

ParameterTypeRequiredDescription
entityIdsstringYesComma-separated entity IDs (1–100)
typestringNoFilter by relationship type

​
Response

{
  "edges": [
    {
      "id": "clxxx001",
      "sourceEntityId": "claaa001",
      "targetEntityId": "clbbb001",
      "type": "RELATED_TO",
      "weight": 0.85,
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-03-20T14:22:00.000Z"
    }
  ]
}

​
Response Fields

FieldTypeDescription
edgesobject[]Edge array (weight descending)
edges[].idstringEdge ID
edges[].sourceEntityIdstringSource entity ID
edges[].targetEntityIdstringTarget entity ID
edges[].typestringRelationship type
edges[].weightnumberWeight score
edges[].createdAtstringCreated timestamp
edges[].updatedAtstringUpdated timestamp

​
Examples

# Get edges connected to specified entities
curl "https://app.snorbe.deskrex.ai/api/v1/graph/edges?entityIds=claaa001,clbbb001" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

# Filter by relationship type
curl "https://app.snorbe.deskrex.ai/api/v1/graph/edges?entityIds=claaa001&type=RELATED_TO" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

​
Error Responses

HTTP StatusCodeDescription
400BAD_REQUESTentityIds is empty or contains more than 100 IDs
401UNAUTHORIZEDInvalid, expired, or missing API key
429TOO_MANY_REQUESTSRate limit exceeded