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

    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