Get a comprehensive overview of event details with the enhanced events log table in the Webhooks page.

Users can now view an enhanced event logs grid, featuring up to three months of logs (previously limited to 100 rows). They can filter events by status code, date, and event type, and also export the events to a file.

To learn more, see Getting started with webhooks.

The Submit a new time off request endpoint now allows you to send any type of request, including time off requests with different hours per day.

The Time off request endpoint now allows you to choose an example according to the request type on the endpoint page, and view the parameters required for each request type. To ensure smooth testing on the endpoint’s page, make sure you select the schema and example for the same type of time off request.

To learn more, see Time off request endpoint.

🚧

Deprecation note: The existing 'Submit a new time off request of different hours per day' endpoint has been deprecated. The different hours per day request is now supported in the main endpoint.

We’re excited to publish a new article: "How to Read Employee Data."

This guide is designed to help you make the most of Bob's API by covering:

  1. The steps to read employee fields via the API.
  2. Understanding the link between fields categories and permissions.
  3. How to fetch fields metadata and convert list items to a human-readable format.
  4. How to read employee tables and custom tables.

Whether you're already deep into your development process or just getting started, we hope this guide becomes a valuable resource for you.

Note: This new guide will replace the "How to work with lists Public API" article.

The documentation for the /search endpoints that return employee data were enhanced to better describe the fields being returned and how to process the response.

Relevant Endpoints:

What’s new?

  • Enhanced documentation for request parameters and response formats.
  • Added examples for the employee response schema with two types of data:
    • Human-readable format (humanReadable="REPLACE")
    • Machine format (humanReadable="")
  • Improved explanation of request parameters.
  • Added a default value for the showInactive parameter, allowing the endpoint to be called without using “Request example”.

The category for the Read Company Positions endpoint has been updated. Previously categorized under "Objects," it is now found under "Workforce Planning."

This change is part of our initiative to group endpoints by modules, providing clearer organization and easier navigation for users. This new categorization enhances clarity when searching for specific endpoints.

The metadata endpoint Get all company fields now retrieves metadata for all employee fields, without requiring any permissions for the service user performing this action.

This update allows developers to seamlessly fetch all field metadata using the API, regardless of category permissions. This way, even if fields are moved between categories, developers can still view the field's category and guide the Admin on which categories the service user needs access to for fetching the actual field data.

To learn more about permissions, see API Service Users.

Field metadata sample:

    {
        "id": "personal.age",
        "category": "personal",
        "name": "Age",
        "description": null,
        "jsonPath": "personal.age",
        "type": "number",
        "typeData": {},
        "historical": false
    },

Changelog provides a list of all changes to the API, including new features and deprecations so you can effortlessly keep track of the latest updates and enhancements.

You can subscribe to the RSS feed, which will notify you whenever a new post in the Changelog is published. This ensures you’re always in the loop with the latest developments.

To get notified about new updates subscribe to the changelog RSS feed using your application of choice (Slack, Outlook, Chrome extension, etc.).

We have updated our documentation to include rate limits for all API endpoints

What has changed:

  • Detailed rate limits: each section in the reference guide now includes a main page which displays the rate limits for all endpoints in that section. This helps you understand the usage limits and plan your API calls accordingly.
  • Rate limits headers: we've included details about HTTP response header which provide real-time information about your current usage and remaining quota.
  • Best practices section: we've added a best practices section with general instructions on how to manage rate limits effectively. This includes tips on optimizing your API usage to stay within the limits and avoid potential issues.

To learn more, see Rate limiting.