Skip to main content
PUT
/
me
/
groups
/
{group}
cURL
curl --request PUT \
  --url https://api.rownd.io/me/groups/{group} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Teammates",
  "admission_policy": "invite_only",
  "meta": {}
}
'
{
  "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": {
    "user_id": "user_fbylaq38591cghym5pabupj2",
    "roles": [
      "owner",
      "editor"
    ],
    "id": "member_dnn5g4e3q6aptail2gr43kpj",
    "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

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token> where <token> is the user's Rownd JWT

Path Parameters

​
group
string
required

Group ID

Body

application/json
​
name
string

The group name

Example:

"My Teammates"

​
admission_policy
enum<string>
default:invite_only

Set whether the group be open for anyone to join or by invite only

Available options:
invite_only,
open
Example:

"invite_only"

​
meta
object

An object containing additional metadata for the group

Response

200 - application/json

Group created successfully

​
group
object
required

The group

​
member
object
required

The group member