API reference

Classes

/groups

A class is who a group-scoped event is about. A static class keeps a list you add to; a dynamic class holds whoever's attributes contain its filter, so nobody keeps it up. Beside the classes somebody keeps are temporary lists, picked by a person for one send: you can see them, but a key cannot change one and an event cannot name one. In the High school pack a class is, for example, “5A”.

GET/groupsList · ?q ?external_ref ?temporary POST/groupsCreate GET/groups/{group_id}Read PATCH/groups/{group_id}Update · attributes replaced wholeshown →POST/groups/{group_id}/membersAdd members · up to 500 GET/groups/{group_id}/membersMembers · static DELETE/groups/{group_id}/members/{member_id}Remove a member POST/groups/syncBuild from an attribute GET/groups/{group_id}/matchesMatches · dynamic POST/groups/{group_id}/deactivateDeactivate · no delete

PATCHUpdate a class

Requires groups:write. Send only what changes — except attributes, which is replaced whole. kind and member_kind never change: make a new class instead. A body that changes nothing is refused.

Path parameters

group_iduuid · required

The class id.

Body parameters

namestring · optional · max 200

filterobject · optional

A dynamic class's only. A static class has none to set (400).

external_refstring · optional · max 200

Changed here, never emptied: blank leaves the one on file alone.

attributesobject · optionalVaries by pack

Generated from the High school pack's group_schema. PATCH replaces the whole object; it does not merge.

KeyLabelKindAllowed valuesRequired

roomRoomtext—No

teacherClass teachertext—No

Returns

200 with the updated class. 409 on a temporary list, which a key cannot change.

Response body

One class: the same fields in every pack. Press Response on the sample to see one whole.

FieldTypeDescription

iduuidWhat an event's group_id names.

namestringUnique in the instance.

kindstatic | dynamicstatic keeps a list; dynamic holds whoever matches its filter.

member_kindsubject | contactWhether it holds students or parents. Fixed when it is made.

filterobject | nullA dynamic group's filter: the student or parent attributes a member's must contain.Varies by pack

derived_fromstring | nullThe subject attribute a group the records keep up was built from. null on a group somebody keeps.

attributesobjectShaped by the High school pack's group_schema.Varies by pack

temporarybooleantrue on a list somebody picked for a send. It cannot be named on an event, and a key cannot change it.

external_refstring | nullYour own id, as you sent it.

statusactive | inactive

created_atdatetime

updated_atdatetime

On failure the body is { error, code } instead.

Previous← Authentication, keys and scopes NextEvent types →