Read the live facets of one edge.

GET

/api/relationships/{edge_handle}/facets

Read-side gate is edges_visible_to — see edge_service::list_edge_facets. Reads stay
service-direct on both surfaces by design (the trait projections are lossy), so this does not
route through the backend.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Responses

🟢200OK

application/json

The edge's live facets

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/relationships//facets' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "edge_handle": "bb448575-c4c7-45c7-a1a2-a9946535e7cb",
    "facets": [
        {
            "authored_by_display_name": "string",
            "authored_by_event_id": "248f8ff9-100a-4c05-848e-d514128c32cf",
            "authored_by_handle": "string",
            "authored_by_profile_id": "9f457820-8c97-4968-9bad-3a986f3801a8",
            "property_id": "05003a8a-8f3c-454b-8884-a906ec46f5f5",
            "property_key": "string",
            "value": null,
            "weight": 0
        }
    ]
}

Modified at 2026-08-19 12:26:18

set_facet

Set a facet whose owner is an **edge** rather than a resource.