organizations
organizations

Create Announcement

Staff broadcast. Body: {title?, body, group_ids?: [..], important?} — no group_ids means org-wide; several ids fan out one announcement per section (Classroom multi-class 'For' pattern). important is the only delivery control a teacher gets, and it is about the MESSAGE, not the channel: it reaches students on the daily digest right away.

The audience is authorized by _require_announcement_scope, not by _require_staff_role: "is a teacher somewhere in this school" was standing in for "may address these people", which is the same substitution _require_group_staff was written to end on the section endpoints.

post/organizations/{org_id}/announcements

Path parameters

org_idstring required

Headers

authorizationstring nullable

Request body

object required

Response

Successful Response

{"stackTrail":"paths:/organizations/{org_id}/announcements:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.