Public API
    Public API
    • Welcome to the deskbird Public API
    • Users
      • Lists company users
        GET
      • Lists single company user
        GET
    • Bookings
      • Lists company bookings
        GET
      • Creates booking
        POST
      • Lists single company booking
        GET
      • Updates booking
        PATCH
      • Cancels booking
        PATCH
      • Check in to the booking
        PATCH
      • Early release the booking
        PATCH
    • Groups
      • Lists company user groups
        GET
      • Lists single company user group
        GET
    • Resources
      • Get a resource by id
        GET
      • Lists company resources
        GET
    • Offices
      • Lists company offices
        GET
      • Check User into Office
        POST
    • Scheduling
      • Lists company scheduling
        GET
      • Delete scheduling statuses by IDs
        DELETE
      • Add new scheduling statuses for a user
        POST
    • Scheduling Options
      • Lists company scheduling options
        GET
    • Rooms
      • Lists company rooms
        GET
      • Gets single room
        GET
      • Lists room bookings
        GET
      • Create a room booking
        POST
      • Gets single room booking
        GET
      • Update a room booking
        PATCH
      • Check in to a room booking
        PATCH
      • Cancel a room booking
        PATCH
    • Schemas
      • BookingStatus
      • Provider
      • ResourceType
      • GuestEmbeddedResponse
      • UserStatus
      • ResourceEmbeddedResponse
      • UserIncludeOptions
      • UserEmbeddedResponse
      • BookingResponse
      • PaginatedBookingResponse
      • AddressResponse
      • OfficeResponse
      • BookingHistoryResponse
      • ResourceResponse
      • EnvelopedOfficeResponse
      • PaginatedResourceResponse
      • CheckUserIntoOfficeBody
      • CreateBookingGuestDto
      • CreateBookingDto
      • UpdateBookingDto
      • CheckInDto
      • SharedResourceAccessInfoResponse
      • DedicatedResourceAccessInfoResponse
      • SchedulingOutput
      • UserStatusInput
      • AddUserStatusesInput
      • SchedulingOptionOutput
      • AttendeeResponse
      • RoomBookingResponse
      • PaginatedRoomBookingResponse
      • RoomBookingDetailedResponse
      • AttendeeDto
      • RoomResponse
      • PaginatedRoomResponse
      • CreateRoomBookingDto
      • UpdateRoomBookingDto

    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
    Early release the booking
    Next
    Lists company user groups
    Built with