SCscipot
edges
edges

List edges in a POT, optionally filtered by type

Changed on

List all edges in a POT, optionally filtered by edge type.

  • pot_id: UUID of the POT
  • type: Optional edge type filter (e.g., contradicts, supports)

Examples: GET /pots/{id}/edges — all edges GET /pots/{id}/edges?type=contradicts — only contradictions

A failed read of the edges or the constitution is 503. Hiding a deactivated axiom's edges needs that constitution; treating a failure as "nothing is inactive" would show edges the list should omit.

get/pots/{pot_id}/edges

Request

Path parameters

pot_idstring uuid required

Query parameters

type'supports' | 'contradicts' | 'resolved_contradiction' | 'refines' | 'derives_from' | 'is_part_of' | 'extends' | 'cites' | 'related_to' | 'supersedes' | 'restates'

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.

Response

Edges retrieved 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 enum value restates to the property anyOf[subschema #1: EdgeType]/ of the query request parameter type

    • info

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