Groups
List groups
Get Started
- Authentication
App-Scoped Endpoints
- Groups
- Group Invitations
- Group Members
- Magic Links
- OpenID Clients
- User Profiles
- User Sessions
User-Scoped Endpoints
- Groups
- Group Invitations
- Group Members
- User Profiles
Groups
List groups
User-facing API for listing groups
GET
/
me
/
groups
curl --request GET \
--url https://api.rownd.io/me/groups \
--header 'Authorization: Bearer <token>'
{
"total_results": 123,
"results": [
{
"group": {
"id": "group_a3l1n2lsnb3q0xbul9enjnh7",
"name": "My Teammates",
"member_count": 0,
"app_id": "327677849595019856",
"admission_policy": "invite_only",
"meta": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"updated_by": "user_t6ftnnmw55pamuhfo9xvw0yl",
"created_by": "user_t6ftnnmw55pamuhfo9xvw0yl"
},
"member": {
"id": "member_dnn5g4e3q6aptail2gr43kpj",
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": [
"owner",
"editor"
],
"state": "active",
"invited_by": "<string>",
"added_by": "<string>",
"profile": {
"user_id": "user_a7b53gwdaml5jt7t71442nt7",
"email": "gary@foo.com",
"first_name": "Gary",
"last_name": "Jackson"
},
"group_id": "group_ig42thhwf4cig25o7t9jtlyu"
}
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
where <token>
is the user's Rownd JWT
Response
200 - application/json
Groups retrieved successfully
The response is of type object
.
curl --request GET \
--url https://api.rownd.io/me/groups \
--header 'Authorization: Bearer <token>'
{
"total_results": 123,
"results": [
{
"group": {
"id": "group_a3l1n2lsnb3q0xbul9enjnh7",
"name": "My Teammates",
"member_count": 0,
"app_id": "327677849595019856",
"admission_policy": "invite_only",
"meta": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"updated_by": "user_t6ftnnmw55pamuhfo9xvw0yl",
"created_by": "user_t6ftnnmw55pamuhfo9xvw0yl"
},
"member": {
"id": "member_dnn5g4e3q6aptail2gr43kpj",
"user_id": "user_fbylaq38591cghym5pabupj2",
"roles": [
"owner",
"editor"
],
"state": "active",
"invited_by": "<string>",
"added_by": "<string>",
"profile": {
"user_id": "user_a7b53gwdaml5jt7t71442nt7",
"email": "gary@foo.com",
"first_name": "Gary",
"last_name": "Jackson"
},
"group_id": "group_ig42thhwf4cig25o7t9jtlyu"
}
}
]
}