Sign in
Groups

Create group

Changed on

This endpoint creates a new group. Corresponds to liveblocks.createGroup.

post/groups

Request

  • Base URL: https://api.liveblocks.io/v2
  • URL: https://api.liveblocks.io/v2/groups
  • Auth: none declared

Request body

idstring required
memberIdsstring[]
organizationIdstring

Example request

{
  "id": "engineering",
  "memberIds": [
    "alice",
    "bob"
  ],
  "organizationId": "org_123456789",
  "scopes": {
    "mention": true
  }
}

Response

Success. Returns the created group.

type'group' required
idstring required
organizationIdstring required
createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "type": "group",
  "id": "engineering",
  "organizationId": "org_123456789",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "scopes": {
    "mention": true
  },
  "members": [
    {
      "id": "alice",
      "addedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "bob",
      "addedAt": "2024-01-16T09:00:00.000Z"
    }
  ]
}

Changes

  • 22a5e987b8c9Revision changes
    • breaking

      request body became required

    • breaking

      the request property const value true was added

    • info

      the response property const value true was added for the status

  • 77cd6a75b2b7Revision changes
    • breaking

      added the new required request property

    • warning

      removed the request property

    • info

      api operation id post-groups removed and replaced with create-group

    • info

      the response property const value group was added for the status

    • info

      removed the group enum value from the response property for the response status