{"result":{"depiction_url":null,"edges":{"in_module":{"objects":[{"created":"2026-09-09T13:48:13Z","object_id":{"id":335,"is_a":["text","documentation","reference","module"],"name":"doc_core","title":"Zotonic Core","uri":"https:\/\/zotonic.com\/id\/335"},"seq":1}],"predicate":{"id":333,"is_a":["meta","predicate"],"name":"in_module","title":{"_type":"trans","tr":{"en":"In module"}},"uri":"https:\/\/zotonic.com\/id\/in_module"}},"references":{"objects":[{"created":"2020-05-30T05:47:55Z","object_id":{"id":1278,"is_a":["text","documentation","reference","model"],"name":"doc_model_model_rsc","title":"rsc","uri":"https:\/\/zotonic.com\/id\/1278"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"refers":{"objects":[{"created":"2026-09-09T13:48:13Z","object_id":{"id":1278,"is_a":["text","documentation","reference","model"],"name":"doc_model_model_rsc","title":"rsc","uri":"https:\/\/zotonic.com\/id\/1278"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"relation":{"objects":[{"created":"2020-05-30T05:47:55Z","object_id":{"id":1278,"is_a":["text","documentation","reference","model"],"name":"doc_model_model_rsc","title":"rsc","uri":"https:\/\/zotonic.com\/id\/1278"},"seq":1000000},{"created":"2020-05-30T05:47:55Z","object_id":{"id":1284,"is_a":["text","documentation","reference","model"],"name":"doc_model_model_media","title":"media","uri":"https:\/\/zotonic.com\/id\/1284"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-09-09T13:48:13Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-09-09T13:48:13Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-09-09T13:48:13Z","object_id":{"id":2574,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_content_relationships","title":"Content relationships","uri":"https:\/\/zotonic.com\/id\/2574"},"seq":3},{"created":"2026-09-09T13:48:13Z","object_id":{"id":2617,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_edge","title":"Edge","uri":"https:\/\/zotonic.com\/id\/2617"},"seq":4},{"created":"2026-09-09T13:48:13Z","object_id":{"id":2625,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_model","title":"Model","uri":"https:\/\/zotonic.com\/id\/2625"},"seq":5},{"created":"2026-09-09T13:48:13Z","object_id":{"id":2643,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_query","title":"Query","uri":"https:\/\/zotonic.com\/id\/2643"},"seq":6}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":1297,"is_a":["text","documentation","reference","model"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1297"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_model_model_edge","page_url":{"en":"https:\/\/zotonic.com\/docs\/1297\/edge","x-default":"https:\/\/zotonic.com\/docs\/1297\/edge"},"preview_url":null,"resource":{"version":3326,"pivot_location_lat":null,"title":"edge","is_authoritative":true,"body":"

Access information about page connections.<\/p>\n

Edges represent the connections between resources. They are implemented as tuples {EdgeId, SubjectId, PredicateId, ObjectId, OrderNr}<\/code>. The edge id is a unique id representing the edge, it can be used with edit actions. The OrderNr defines the\norder of the edges with respect to the subject.<\/p>\n

Most edge information is accessed using the model#rsc<\/code><\/a> model, but some information can only\naccessed with the m_edge model.<\/p>\n

This model implements two template accessible options. They are mainly used to obtain the edge's id for edit pages.<\/p>\n

The following m_edge model properties are available in templates:<\/p>\n
Property<\/th>Description<\/th>Example value<\/th><\/tr><\/thead>
o<\/td>Returns a function that accepts a page id and a predicate. The end result is a list of tuples {PageId, EdgeId} which are objects of the page. Example usage: m.edge.o[id].author<\/code><\/td>[{204,13},{510,14}, {508,15}]<\/code><\/td><\/tr>
s<\/td>Identical to the "o" property, except that this function returns the subject edges.<\/td><\/td><\/tr>
o_props<\/td>Similar to m.edge.o[id].author<\/code> above, but returns a property list for the edges instead of the 2-tuple.<\/td>> [ > {id, 86062}, > {subject_id, 10635}, > {predicate_id, 304}, > {object_id, 57577}, > {seq, 1}, > {creator_id, 1}, > {created, { > {2015,11,17}, > {11,23,32} > }} > ] > ]<\/code><\/td><\/tr>
s_props<\/td>Similar to m.edge.s[id].author<\/code> above, but returns a property list for the edges instead of the 2-tuple.<\/td><\/td><\/tr>
edges<\/td>Returns a function that accepts a page id. The end result is a list of edges per predicate where the predicate is an atom and the edges are property lists. Example usage: m.edge[10635]<\/code><\/td>See example below.<\/code><\/td><\/tr>
id<\/td>Look up an edge id by a subject\/predicate\/object triple. Example usage: erlang m.edge.id[subject_id].relation[object_id] <\/code> or: erlang m.edge.id[subject_id][predicate_name][object_id] <\/code> Returns undefined<\/code> if the edge does not exist; otherwise returns an integer.<\/td>213<\/code><\/td><\/tr><\/tbody><\/table>\n

Example return value for {% print m.edge[10635] %}<\/code>:<\/p>\n

[{about,[[{id,86060},\n          {subject_id,10635},\n          {predicate_id,300},\n          {name,<<"about">>},\n          {object_id,17433},\n          {seq,1},\n          {created,{{2015,11,17},{11,22,11}}},\n          {creator_id,1}]]},\n {author,[[{id,6},\n           {subject_id,10635},\n           {predicate_id,301},\n           {name,<<"author">>},\n           {object_id,10634},\n           {seq,1000000},\n           {created,{{2015,2,3},{16,23,20}}},\n           {creator_id,1}]]}]\n<\/code><\/pre>\n
Other Topics<\/h2>\n
model\/edge\/post\/o\/+subject\/+predicate\/+object<\/code> or model\/edge\/post\/s\/+object\/+predicate\/+subject<\/code> inserts a new edge between resources.<\/p>\n
The posted message can optionally include the name or id of the object, predicate and subject.<\/p>\n
cotonic.broker.publish("bridge\/origin\/edge\/post\/o\/4312",\n                       {\n                         predicate: "author",\n                         subject: 7575\n                       });\n<\/code><\/pre>\n
It is also possible to insert edges via cotonics onclick topics.<\/p>\n
<div data-onclick-topic="bridge\/origin\/model\/edge\/post\/o\/{{ id }}\/?\/{{ m.acl.user }}">\n   <button data-edge-predicate="is_going">Is Going<\/button>\n   <button data-edge-predicate="is_interested">Might Go<\/button>\n<\/div>\n<\/code><\/pre>\n
When a user clicks on a button, the model retrieves the predicate name (or id) from the data-edge-predicate<\/code> attribute.\nThis is also possible by for the object and subject attributes of the edge. When there is a ?<\/code> in the topic path, the\nvalue can be retrieved from a data attribute. The attribute value for object is: data-edge-object<\/code>. For subject it is: data-edge-subject<\/code>.\nIf all path parts from the first ?<\/code> to the end are ?<\/code>, then those trailing ?<\/code> parts may be omitted from the topic path.<\/p>\n
model\/edge\/delete\/o\/+subject\/+predicate\/+object<\/code>, model\/edge\/delete\/s\/+object\/+predicate\/+subject<\/code> or model\/edge\/delete\/edge\/+edge_id<\/code> deletes the specified edge.<\/p>\n
cotonic.broker.publish("bridge\/origin\/edge\/delete\/edge\/6776");\n<\/code><\/pre>\n
Or via a onclick topic.<\/p>\n
<button data-onclick-topic="bridge\/origin\/edge\/delete\/{{ edge_id }}">Delete<\/button\n<\/code><\/pre>\n
Available Model API Paths<\/h2>\n
Method<\/th>Path pattern<\/th>Description<\/th><\/tr><\/thead>
get<\/code><\/td>\/o\/+id\/+pred\/...<\/code><\/td>Return outgoing edge tuples {ObjectId, EdgeId}<\/code> from subject +id<\/code> for predicate +pred<\/code> (subject must be visible).<\/td><\/tr>
get<\/code><\/td>\/o_props\/+id\/+pred\/...<\/code><\/td>Return outgoing edge rows (id\/subject\/predicate\/object\/seq\/created\/creator) from subject +id<\/code> for predicate +pred<\/code>.<\/td><\/tr>
get<\/code><\/td>\/s\/+id\/+pred\/...<\/code><\/td>Return incoming edge tuples {SubjectId, EdgeId}<\/code> pointing to object +id<\/code> for predicate +pred<\/code> (object must be visible).<\/td><\/tr>
get<\/code><\/td>\/s_props\/+id\/+pred\/...<\/code><\/td>Return incoming edge rows (id\/subject\/predicate\/object\/seq\/created\/creator) for object +id<\/code> and predicate +pred<\/code>.<\/td><\/tr>
get<\/code><\/td>\/edges\/+id\/...<\/code><\/td>Return all outgoing edges of resource +id<\/code> grouped by predicate name.<\/td><\/tr>
get<\/code><\/td>\/id\/+subjectid\/+pred\/+objectid\/...<\/code><\/td>Return edge id for (+subjectid<\/code>, +pred<\/code>, +objectid<\/code>) or undefined<\/code> if absent (subject must be visible).<\/td><\/tr>
get<\/code><\/td>\/graph\/...<\/code><\/td>Return graph map (nodes<\/code>, edges<\/code>, is_truncated<\/code>) for payload ids<\/code>, with optional payload options limit<\/code> and unescape<\/code>.<\/td><\/tr>
get<\/code><\/td>\/+id<\/code><\/td>Return same grouped outgoing-edge data as \/edges\/+id<\/code> for resource +id<\/code>. No further lookups.<\/td><\/tr>
post<\/code><\/td>\/o\/...<\/code><\/td>Insert one edge using object-oriented argument order (subject, predicate, object)<\/code>; values come from path segments, payload keys, message.data-edge-*<\/code>, or query args.<\/td><\/tr>
post<\/code><\/td>\/s\/...<\/code><\/td>Insert one edge using subject-oriented path order (object, predicate, subject)<\/code>; stored edge is still (subject, predicate, object)<\/code>.<\/td><\/tr>
delete<\/code><\/td>\/o\/...<\/code><\/td>Delete edge(s) using object-oriented order (subject, predicate, object)<\/code>.<\/td><\/tr>
delete<\/code><\/td>\/s\/...<\/code><\/td>Delete edge(s) using subject-oriented path order (object, predicate, subject)<\/code>; this maps to stored triple (subject, predicate, object)<\/code>.<\/td><\/tr>
delete<\/code><\/td>\/edge\/+edge<\/code><\/td>Delete a single edge by edge id +edge<\/code> (invalid id returns enoent<\/code>). No further lookups.<\/td><\/tr><\/tbody><\/table>\n
\/+name<\/code> marks a variable path segment. A trailing \/...<\/code> means extra path segments are accepted for further lookups.<\/p>\n
Post Method Examples<\/h2>\n
Path orientation notes:<\/p>\n
  • Object-oriented path (\/o\/...<\/code>) uses order: subject \/ predicate \/ object<\/code>.<\/li>
  • Subject-oriented path (\/s\/...<\/code>) uses order: object \/ predicate \/ subject<\/code>.<\/li>
  • Both forms create or delete the same edge triple in storage: (subject, predicate, object)<\/code>.<\/li>
  • Trailing wildcard parts can be omitted: if all path parts from the first ?<\/code> to the end are ?<\/code>, you may stop the path at that first ?<\/code>.<\/li><\/ul>\n
    Insert via object-oriented path:<\/p>\n
    cotonic.broker.call(\n    "bridge\/origin\/model\/edge\/post\/o\/7575\/author\/4312",\n    {}\n);\n<\/code><\/pre>\n
    Insert via wildcard path values (?<\/code>) resolved from payload:<\/p>\n
    cotonic.broker.call(\n    "bridge\/origin\/model\/edge\/post\/o\/?\/?\/?",\n    {\n        subject: 7575,\n        predicate: "author",\n        object: 4312\n    }\n);\n<\/code><\/pre>\n
    Insert with trailing wildcards omitted (only subject in path, predicate\/object from payload):<\/p>\n
    cotonic.broker.call(\n    "bridge\/origin\/model\/edge\/post\/o\/7575",\n    {\n        predicate: "author",\n        object: 4312\n    }\n);\n<\/code><\/pre>\n
    Insert with all values from payload (shortest path):<\/p>\n
    cotonic.broker.call(\n    "bridge\/origin\/model\/edge\/post\/o",\n    {\n        subject: 7575,\n        predicate: "author",\n        object: 4312\n    }\n);\n<\/code><\/pre>\n
    Insert via subject-oriented path:<\/p>\n
    cotonic.broker.call(\n    "bridge\/origin\/model\/edge\/post\/s\/4312\/author\/7575",\n    {}\n);\n<\/code><\/pre>","slug":"edge","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"82d0de5d028569e72187cbdcc1c4cc08b00ea190557e0296301560682f96a703","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":322,"is_a":["meta","category"],"name":"model","title":"Models","uri":"https:\/\/test.zotonic.com\/id\/322"},"doc_source_path":"apps\/zotonic_core\/src\/models\/m_edge.erl","publication_start":"2023-01-30T19:23:55Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_core\/src\/models\/m_edge.erl","pivot_location_lng":null,"doc_source_kind":"model","name":"doc_model_model_edge","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:17Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_core","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"b8c4b2ccdc223257f311968fbd17b2d66f0c4156\n","erlang_module":"m_edge","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-09-30T09:39:54Z","title_slug":"edge"},"uri":"https:\/\/zotonic.com\/id\/1297","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1297"}},"status":"ok"}