circle_link

Fields

Field	Type	Description
id	uuid	Unique identifier for the circle link
parentId	uuid	Reference to the hosting circle
circleId	uuid	Reference to the invited circle
createdAt	Timestamp	When the circle link was created

Relationships

Object Relationships:

• hostCircle — The circle that hosts the linked circle (referenced by parentId)
• invitedCircle — The circle that is invited to participate (referenced by circleId)

Query Examples

Get Links for a Specific Circle

query GetCircleLinks($parentId: uuid!) {
  circle_link(where: { parentId: { _eq: $parentId } }) {
    id
    hostCircle {
      id
      role {
        name
      }
    }
    invitedCircle {
      id
      role {
        name
      }
    }
    createdAt
  }
}

Mutation Examples

Create a Circle Link

mutation CreateCircleLink {
  insert_circle_link_one(
    object: { parentId: "host-circle-id", circleId: "invited-circle-id" }
  ) {
    id
    hostCircle {
      role {
        name
      }
    }
    invitedCircle {
      role {
        name
      }
    }
  }
}

Remove a Circle Link

mutation RemoveCircleLink {
  delete_circle_link(
    where: {
      parentId: { _eq: "host-circle-id" }
      circleId: { _eq: "invited-circle-id" }
    }
  ) {
    affected_rows
  }
}

Permissions

• Organization owners: Full access
• Organization admins/members: Can create links if governance is not protected
• Circle leaders of the host circle: Can create and manage links
• Public: Limited to viewing links in organizations with shared member information