collegia

Create a collegium; the creator becomes its first admin

Changed on
post/api/collegia

Request

  • The document declares no server URL.
  • Auth: none declared

Request body

descriptionstring nullable
is_privateboolean nullable
namestring required
review_visibility'members' | 'stewards'

Who reviews submissions: everyone (members, the writing-circle mode) or stewards only (stewards, the classroom mode). Stored as the Postgres enum collegium_review_visibility; governs new submissions only (each review request snapshots it).

Response

Collegium created

created_atstring required
descriptionstring nullable
idstring required
invite_tokenstring nullable

Admins only; absent for stewards too when no invite link is active (my_role tells the frontend whether the field is authoritative).

is_privateboolean required
member_countinteger required
my_pending_requestboolean required
my_role'steward' | 'member'

A member's standing in a collegium. Stored as the Postgres enum collegium_member_role; stewards run the collegium (settings, membership, invite links, closing rounds).

namestring required
pending_join_request_countinteger nullable

Admins only.

review_visibility'members' | 'stewards' required

Who reviews submissions: everyone (members, the writing-circle mode) or stewards only (stewards, the classroom mode). Stored as the Postgres enum collegium_review_visibility; governs new submissions only (each review request snapshots it).

slugstring required

Changes