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 a new resource booking
        POST
      • Gets a single company booking
        GET
      • Updates an existing booking
        PATCH
      • Cancels a booking
        PATCH
      • Checks in to a booking
        PATCH
      • Releases a booking early
        PATCH
    • Groups
      • Lists company user groups
        GET
      • Lists single company user group
        GET
    • Resources
      • Gets a resource by ID
        GET
      • Lists company resources
        GET
    • Offices
      • Lists company offices
        GET
      • Checks a user into an office
        POST
    • Scheduling
      • Lists company scheduling statuses
        GET
      • Deletes scheduling statuses by IDs
        DELETE
      • Adds new scheduling statuses for a user
        POST
    • Scheduling Options
      • Lists company scheduling options
        GET
    • Rooms
      • Lists company rooms
        GET
      • Gets a single room
        GET
      • Lists room bookings
        GET
      • Creates a room booking
        POST
      • Gets a single room booking
        GET
      • Updates a room booking
        PATCH
      • Checks in to a room booking
        PATCH
      • Cancels 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
      • OpeningHourResponse
      • OpeningHoursResponse
      • 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
    Releases a booking early
    Next
    Lists company user groups
    Built with