SCscipot
edges
edges

Create edges between facts

Changed on

Create one or more edges between facts in a POT.

After creating edges, runs POT Score propagation to update affected fact scores based on the new relationships.

  • pot_id: UUID of the POT
  • edges_data: List of edge definitions (from_id, to_id, type, weight, rationale), at most EDGE_CREATE_BATCH_MAX (100) per request

Returns the created edges and triggers POT Score propagation. Sent with X-Episode-ID (point 6), every edge records that episode and is linked to it.

post/pots/{pot_id}/edges

Request

Path parameters

pot_idstring uuid required

Request body

from_idstring uuid required
to_idstring uuid required
type'supports' | 'contradicts' | 'resolved_contradiction' | 'refines' | 'derives_from' | 'is_part_of' | 'extends' | 'cites' | 'related_to' | 'supersedes' | 'restates' required

Types of semantic relationships between facts.

M7 uses a simplified subset. Full taxonomy in edge-types.md will be implemented in M8+ when GraphRAG is introduced.

weightnumber required
rationalestring
detected_bystring
confidencenumber

Response

Edges created successfully

totalinteger required
pot_idstring uuid required

Changes

  • 7764b32b043bRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 0fb6ed61ba72Revision changes
    • warning

      added the new restates enum value to the // response property for the response status

    • info

      added the new restates enum value to the request property /

    • info

      added the optional property // to the response with the status