How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

UW Groups Web Service (GWS)

The University of Washington Group Service API — UW-IT's institution-operated group registry and membership service. UW publishes the OpenAPI itself, with an explicit termsOfService (washington.edu/online/terms), an Apache-2.0 license declaration and a help@uw.edu contact, and its servers[] name the production, evaluation and development hosts as well as a deprecated UWCA-certificate host. eduPersonPrincipalName is modelled directly in the contract.

UW Groups Web Service (GWS) is one of 32 APIs that University of Washington publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Identity, Group, Membership, IAM, and Enterprise Web Services. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 18 operations across 11 paths, organized into 3 resource areas, and defines 32 schemas. It is described by OpenAPI 3.0.0, at version 2.3.x.

Requests are made against 4 base URLs: https://groups.uw.edu/group_sws/v3, https://eval.groups.uw.edu/group_sws/v3, https://dev.groups.uw.edu/group_sws/v3, https://iam-ws.u.washington.edu/group_sws/v3.

18 operations 11 paths 32 schemas 3 DELETE10 GET5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.3.x
Base URL
https://groups.uw.edu/group_sws/v3
License
Terms of Service
Resource Areas
3

Paths & Operations 18

Across 11 paths, the API surfaces 18 operations — 3 DELETE, 10 GET, 5 PUT. They span 3 resource areas: Groups, Membership, Searches. Each is listed below with its method, path, parameters, and response codes.

Groups 8

Group information--except membership

GET
/group/{groupid}
Get the group referenced by the groupid.
getGroup 3 params → 200304404406
PUT
/group/{groupid}
Create or update a group. The PUT and POST methods are identical.
putGroup 5 params body → 2002014004014044064125xx
DELETE
/group/{groupid}
Delete a group
deleteGroup 2 params → 200401406
PUT
/groupMove/{groupid}
Renames a group or moves a group to a new stem. Idempotent if the group id is specified with a regid. One of newext or newstem is required.
3 params → 200400401406
GET
/group/{groupid}/affiliate/{affiliate}
Get the specified affiliate of the group.
getAffiliate 3 params → 200404406
PUT
/group/{groupid}/affiliate/{affiliate}
Put the affiliate of the group
putAffiliate 7 params → 200201400401406
DELETE
/group/{groupid}/affiliate/{affiliate}
Delete an affiliate
deleteAffiliate 2 params → 200401406
GET
/group/{groupid}/history
Gets history of the group
getHistory 7 params → 200401404406
Membership 9

Group membership information

GET
/group/{groupid}/member
Gets all direct members of the group
getMembership 3 params → 200401403404406
PUT
/group/{groupid}/member
Put entire membership of the group. The PUT and POST methods are identical.
putMembership 4 params body → 200401404406
GET
/group/{groupid}/member?view=count
Gets direct membership count
getMembershipCount 4 params → 200401403404406
GET
/group/{groupid}/member/{memberid}
Gets one member of the group
getMember 4 params → 200401404406
PUT
/group/{groupid}/member/{memberid}
Put a member(s) into the group. Specified ids are added. No members are removed.
putMember 5 params → 200401404406
DELETE
/group/{groupid}/member/{memberid}
Delete a member(s) from the group. Specified ids are removed.
deleteMember 3 params → 200401404406
GET
/group/{groupid}/effective_member
Gets all effective members of the group. All direct members of the group plus all effective members of member groups.
getEffectiveMembership 2 params → 200401404406
GET
/group/{groupid}/effective_member?view=count
Gets effective membership count
getEffectiveMembershipCount 4 params → 200401403404406
GET
/group/{groupid}/effective_member/{memberid}
Gets one effective member of the group
getMember 4 params → 200401404406
Searches 1

Group and member searches

GET
/search
Finds groups. Parameters specify matching conditions, which are ANDed to generate the search result. Note. The affiliate search ignores any other search parameters.
10 params → 200401404406

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are Group (20 properties), MemberCountMeta (7 properties), MemberMeta (7 properties), HistoryEntry (5 properties). Each schema is shown below with its type and property counts.

uwnetid
string
A University of Washington UWNetID
eppn
string
An eduPersonPrincipalName or an email address
dns
string
A Domain Name System (DNS) address
uwwi
string
A Microsoft Infrastructure (MI) machine name (with a $ appended)
affiliate
string
An affiliate type
emailSenders
string
Exchange Email senders - a comma separated list of ids
googleSenders
string
Google Groups senders - choice keyword
Group
object
20 properties 9 required
GroupResponse
object
3 properties
PutGroup
object
1 property 2 required
Affiliate
object
4 properties 2 required
AffiliateResponse
object
3 properties
PutAffiliate
object
3 properties
Entity
object
An eitity
3 properties
Instructor
object
A course instructor
3 properties
Member
object
A direct group member.
2 properties
EffMember
object
An effective group member. (direct or member of member group)
4 properties
PutMember
object
A group member.
2 properties
MemberMeta
object
7 properties
Membership
object
3 properties
EffMembership
object
3 properties
PutMembership
object
1 property
MissingMembers
object
2 properties
MemberCountMeta
object
7 properties
MembershipCount
object
3 properties
SearchResponse
object
3 properties
GroupReference
object
A group reference
4 properties 3 required
History
object
3 properties
HistoryEntry
object
A group activity
5 properties
Error
object
2 properties
GroupSchema
array
ErrorMeta
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

university-of-washington-groups-web-service-openapi.yml Raw ↑

Other APIs University of Washington publishes across the network.

Identity Registration Web Service (IRWS)
UW-IT Enterprise Web Services Registry
UW Token Authentication Web Service (TAWS)
UW Shibboleth Identity Provider (InCommon)
ResearchWorks Repository (DSpace REST + OAI-PMH)
Student Web Service (SWS) Campus API
IdCard Web Service (IdCardWS) Card API
Student Web Service (SWS) College API
Student Web Service (SWS) Course API
Student Web Service (SWS) Curriculum API
Student Web Service (SWS) Degree API
Student Web Service (SWS) Degree Audit API
Where this information came from

This is an independent, third-party profile of UW Groups Web Service (GWS), published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.