1. Public API
Public API
  • Welcome to the deskbird developer docs
  • Public API
    • Overview
    • Users
      • Lists company users
      • Retrieves a single company user
    • Bookings
      • Lists company bookings
      • Creates a new resource booking
      • Gets a single company booking
      • Updates an existing booking
      • Cancels a booking
      • Checks in to a booking
      • Releases a booking early
    • Groups
      • Lists company user groups
      • Retrieves a single company user group
    • Resources
      • Gets a resource by ID
      • Lists company resources
    • Offices
      • Lists company offices
      • Checks a user into an office
    • Scheduling
      • Lists company scheduling statuses
      • Deletes scheduling statuses by IDs
      • Adds new scheduling statuses for a user
    • Scheduling Options
      • Lists company scheduling options
    • Rooms
      • Lists company rooms
      • Gets a single room
      • Creates a room booking
      • Lists room bookings
      • Gets a single room booking
      • Updates a room booking
      • Checks in to a room booking
      • Cancels a room booking
      • Lists company room bookings
    • Floors
      • Lists company floors
    • Zones
      • Lists company zones
    • Tickets
      • Lists company tickets
      • Gets a single company ticket
      • Lists ticket categories
      • Updates a ticket
    • Sensors
      • Lists company monitors
      • Lists company network configurations
    • Visitors
      • Lists company visit types
      • Lists company visits
      • Gets a single company visit
    • Service requests
      • Lists company service requests
      • Lists service categories of an office
      • Gets a single company service request
  • MCP server
    • Overview
    • Authentication
    • Tools reference
  1. Public API

Groups

The Groups API allows you to retrieve group data from the Deskbird system. You can fetch multiple groups with pagination support or retrieve details of a specific group.

Authentication#

All group-related endpoints require authentication via a valid API Key in the Authorization header. Ensure that you include a valid API key in your requests.

Endpoints#

1. Get Groups#

Endpoint:
GET /groups
Description:
Retrieves a list of groups with optional pagination.
Query Parameters:
limit (integer, optional) – The maximum number of groups returned per request.
offset (integer, optional) – The starting point for retrieving groups (used for pagination).
Headers:
Authorization: Bearer <your_api_key>
Example Request:

2. Get Single Group#

Endpoint:
GET /groups/{groupId}
Description:
Retrieves details of a specific group by its unique groupId.
URL Parameters:
groupId (string, required) – The unique identifier of the group to be fetched.
Headers:
Authorization: Bearer <your_api_key>
Example Request:

By using the Groups API, you can efficiently manage groups while ensuring secure access through token-based authentication.
Previous
Releases a booking early
Next
Lists company user groups
Built with