Previously, service users could access employee profile pictures without being assigned to any permission group.
What this change?
Moving forward, visibility of avatars through the API is restricted based on the About category permission, aligning it with other employee data access rules.
To allow the service user to read the avatar, you now need to enable the permission:
People's data > About > View selected employees' About sections.
Workforce Planning now supports prorated position costs. When you define your fiscal year and add an end date to a position, the platform automatically calculates the cost based on how long the position is active during that financial cycle.
You can now access these details through the Public API:
The /position/endEffectiveDate field is available on the position object. It indicates when the position’s cost should stop being included in planning.
The /position/positionBudget/proRatedCostCurrencyValue field is available on the position budget. It shows the calculated prorated cost of the position, converted to your company’s base currency.
This gives you API visibility into how position costs are prorated, helping you align external reports or tools with your workforce planning data.
We’re experimenting with short audio recaps and deep dives to make our documentation more accessible. The first ones are live at the end of the article:
Each provides a quick, AI-generated summary that highlights the main points.
We're curious if this format is useful to you, so feel free to share feedback via the vote option at the bottom of the article (and please include your email so we can follow up!).
Final Notice: API Get Endpoints Shutdown by May 6, 2025
The Get endpoints listed below will be completely shut off by May 6, 2025.
GET api.hibob.com/v1/people
GET api.hibob.com/v1/people/XXXX
If your organization is still using the deprecated endpoints, action is required to prevent disruptions. Any processes relying on these endpoints will stop working, potentially impacting your operations. Follow the instructions below to migrate to the new Search API to replace the two GET endpoints.
❗️
Final Notice: API Access Tokens Shutdown by May 6, 2025
The "API Access Token" authentication method will be completly shut off by May 6, 2025.
Companies using this legacy method should transition to the Service User method immediately. From this date, API integrations using API Access Tokens will stop working. Any system or process that relies on API Access Tokens will fail, potentially causing disruptions.
We’ve enabled two AI-friendly features to support AI tools in parsing and interacting with our docs:
llms.txt file – A dedicated file that's now available on our website. Give it to AI tools like ChatGPT or Claude and ask it questions about our API. It will help them to better understand and navigate our API docs and provide better answers.
AI Dropdown – You’ll now see a new dropdown on every article page with options to:
Ask ChatGPT or Claude about the article
Copy the page as Markdown
View it in plain Markdown
These updates are especially helpful if you use AI to summarize or extract content, or when you need to access machine-readable versions of our docs.
You can now download API audit logs to monitor usage of Bob’s public API. Logs include request metadata such as timestamp, endpoint, method, status code, service user ID, and query parameters.
You can access the API audit logs from Bob's System settings > Account > API audit.
What's new?
We've added source_ip column to each log entry for improved traceability and security auditing.
You can allow users who are not Admins to download API audit logs.by granting them the following permission: Features > Settings > Audit > Read and download company Audit data.
This field indicates when each request was created.
Note that you could already filter requests using the since and to query parameters — which refer to the request's creation date. With this update, the same creation date is returned in the response (createdOn), giving you clearer visibility into the data you're querying.
Bob's Job Catalog 2.0 is a database that details the hierarchy of all the jobs in your organization.
📘
Note:
The new job catalog API is available only for users working with the new Job catalog 2.0, currently open only to new customers and customers who had not used the job catalog before February 9, 2025. To learn more, see Getting started with the new job catalog ↗.
What’s new:
Job profile search: Filter job profiles by status, job family group, job family, and job role for targeted reporting and integration.
Job catalog metadata: Access detailed metadata for job profiles, job family groups, job families, and job roles, including available fields and custom attributes.
Job content library: Retrieve complete lists of job family groups, job families, and job roles to get a comprehensive view of your catalog.