API Reference

`circle_participant`

A computed view representing all participants in a circle, including direct members and inherited participants from child and linked circles.

Not accessible through the public API

This entity is not directly accessible via the public API. It is a computed view used internally for permission checks and participant resolution.

Fields

Field	Type	Description
`circleId`	`uuid`	Reference to the circle
`memberId`	`uuid`	Reference to the member

Relationships

Object Relationships:

circle — The circle this participant belongs to
member — The member who is a participant

Participant Sources

Circle participants are derived from three sources:

Direct circle members — from circle_member (active memberships only)
Leaders of child circles — from circle_leader through parent-child relationships
Leaders of linked circles — from circle_leader through circle links

Implementation Details

The view is a UNION of three queries and is cached in circle_participant_cache for performance. The cache is automatically maintained through database triggers when circle structure changes occur.

Notes

Participant status affects access to meetings, tasks, and decisions within the circle. The cache is used for efficient permission checks throughout the system.