Skip to main content

API Releases

Latest API updates from release notes

Written by Ellen Rydberg

Release Version 11.88

Wednesday, November 18
​
​API
​
• Candidate custom field values — Candidate responses now include customFieldValues. Use PUT /v0.1/companies/{companyId}/candidates/{candidateId}/custom-fields to update custom field values (partial update; requires the Custom fields and Recruitment modules and the recruiter role). A values update counts as a candidate change: it triggers the candidate webhook and a search reindex.
• Search candidates by custom field — POST /v0.1/companies/{companyId}/candidates/search now accepts customFields (the same filter group as the subcontractor search) to filter candidates on custom field values (requires the Custom fields module). Invalid filters return 400.
• Team locationId is now stored — locationId on POST/PUT teams is now stored (it was ignored before) and must be one of the company's location addresses, otherwise the request returns 400. Team names longer than 100 characters now return 400 instead of 500.

[10:18 AM]

• Custom field numeric values as JSON numbers — Numeric values in a custom field definition's config (decimals, min, max, minLength, maxLength) are now returned as JSON numbers, as the OpenAPI document states. They were returned as strings before.
• OpenAPI documentation updates — The OpenAPI document no longer marks company countryId, registrationYear and isTaxRegistered; customer intermediator; skill set isPrivate; and search event isOverdue and assignedToUserShowAsDeleted as nullable. The OpenAPI document no longer marks id as nullable on addresses, roles, keywords, keyword synonyms, attachments, companies, profiles, profile items (presentation, employers, work experiences, educations, trainings, references, skills, commitments, languages), resumes, events, event comments, role members, user skills (id, profileId, level), and projects (createdDateTime). The OpenAPI document no longer marks company and customer on a project as nullable and lists both as required. The OpenAPI document no longer marks companyCustomerManagerId and customerId on customer managers, hasTime and hasAttendees on search events, and comments on a single event as nullable; comments is also listed as required. All responses are unchanged.
• Customer managers include companyUserType — Customer managers now include companyUserType (always 0, employee) on the customer manager endpoints and in managers / customerManagers on customers and users.
• Training endpoints users field corrected — users[].id on the training endpoints now holds the user's id, like companyUserId. It previously held the id of the user's profile training entry.
• Large event search pages fixed — POST /companies/{companyId}/events/search now works for large pages (itemsPerPage in the thousands), which failed with 500 or 504 after release 11.87.
• Training not found returns 404 — GET /v0.1/companies/{companyId}/trainings/{trainingType}/{id} now answers 404, not 500, when the training does not exist or has another training type.


Release Version 11.86

2026-10-06


​
​API
• Resume endpoints — New endpoints to create and delete a company user's resume. Requests for an unknown resume id now return 404 instead of 401.

[9:50 AM]

• Resume blocks and educations — New endpoints to list a resume's blocks and read its Educations block and entries (addressed by profile education id). GET /templates/{id} now returns the template's blocks.
• Subcontractor fields and operations — Responses now include title, calendar, timezone, and last-touch fields. Create requests can include custom fields and a welcome-email request; tags can be added and removed through the API.
• Employee fields and validation — Responses include additional profile fields. Creation accepts more app add-flow fields, validates calendar, currency and country, and can send the welcome email through SendWelcomeEmail.
• Employee mobility and availability now restricted — These fields are returned only to CompanyManager and CompanyAdmin callers, including on /users/extended.
• Candidate update and read fields — Integrations can now do a full PUT update to candidate records, and can read state reason, location, stage-change and audit fields.
• Team endpoints accept locations — Team endpoints now accept free-text locations and return member counts of active members.
• Project state reason and references — Responses now return the current state reason ID when one is set. Writes accept the state date and reference state; project roles return audit fields, location, commitment and skill mandatory flags.
• Customer contact fields and management — Responses now include LinkedIn URLs, status and audit fields. The API now supports contact relation management and accepts additional fields in customer updates.
• Resume Educations entries — New endpoints to create or update (PUT) and remove (DELETE) the entry for a profile education in a resume's Educations block. They change only that block; profile educations are read, never written.
• Resume Commitments block and entries — New endpoints to read a resume's Commitments block and to create or update (PUT) and remove (DELETE) the entry for a profile commitment in it. They change only that block; profile commitments are read, never written.
• Role custom field filtering — POST /roles can now filter on role custom field values with customFields, like Search projects.
• Correlation ID in error responses — The API description and error model now ask you to quote the X-Correlation-ID response header when contacting support. Internal: request spans carry the signed-in company and user ids and the correlation id when telemetry is enabled.
• assignedToCompanyUserId deprecated — This field on event responses and on event note, meeting and task POST/PUT requests is now marked deprecated in the OpenAPI spec. Use assignees and the /events/{eventId}/assignees endpoints instead. The field still works.
• JSON Patch validation — PATCH requests with a JSON Patch operation that has no path, or a move/copy without from, now return 400 with a validation error instead of 500.
• Candidate custom fields — The custom field definition endpoints now accept Candidate as an entity type. Candidate values cannot be read or written yet; that arrives in a later release.
• Role location preserved on PUT — Editing a role through PUT /roles/{id} no longer clears the role's location.


Release Version 11.85

2026-10-27
​
​API
• Profile commitment read no longer returns 403 — Reading a single profile commitment by id (GET …/profile/commitments/{id}) no longer returns 403 Forbidden for users who can view the profile.
• Null dates documented — Created, updated and last-touched dates on customer contacts, customer domains, candidates, subcontractors, events, discussions and profile items are now documented as nullable, matching the null values the API already returns.
• Candidate accounts start in recruiter's language — New candidate accounts created or invited through the API now start in the API user's language, with the welcome email also in that language.
• Team update errors fixed — Updating a team that does not exist now returns 404 Not Found instead of 500 Internal Server Error, and is documented in the OpenAPI spec for UpdateTeam. Deleting a team that does not exist now returns 404 Not Found instead of 400 Bad Request.
• Discussion post creation returns author — Creating a discussion post now returns the post's createdBy field in the response, consistent with reading or editing a post.
• Team manager endpoint uses URL team id — Adding a team manager now always uses the team id in the URL. The teamId field in the request body is optional; if present and different from the URL, the request returns 400 Bad Request.

[10:48 AM]

• Stricter access checks on team and tag endpoints — The team member endpoint (GET /companies/{companyId}/teams/{teamId}/members/{id}) and the tag types endpoint (GET /companies/{companyId}/tag-types) now require at least the CompanyUser access level. Callers with lower access get 403 Forbidden.


Release Version 11.84

2026-10-22
​
​API
• Roles support custom fields — Custom field values are returned on GET roles/{id} and can be set with PUT roles/{roleId}/custom-fields. This endpoint updates only the fields you send. A values-only update counts as a role change and triggers the role-changed webhook, so bulk syncing sends one webhook per role. A role's custom field values are removed when the role, its project, its customer or the company is deleted, or when the role is converted to a commitment.
• Profile presentation translation fix — Updating a profile presentation now saves to the translation given in profileTranslationId instead of always to the primary translation. An unknown profileTranslationId returns 400.
• App Market integrations can manage absences — App Market integrations with Manager or Admin scope can now create, edit and delete absences for other users. Admins without the separate Manager role can also manage other users' absences.


Release Version 11.83

2026-10-21


​
​API
• Project searches include projects without a last-touch date — When no last-touch date filter is specified, the search now returns projects that have never been touched.
• Detailed employee responses include DisplayCurrency — PUT and PATCH preserve the stored currency when the request omits it.
• Project searches no longer skip or duplicate projects — Paging through projects/search now returns each project exactly once. The default sort orders by created date, and all paged search endpoints order ties by id.
• Email, Identification and Status searches now sort by that field — Searching users by Email, customers by Identification, and candidates by Status now sorts the results by that field. Previously these sort options were ignored. Sorting customers by Status sorts by creation date.
• New bookings endpoints for consultants — The Cinode API can now list the bookings a consultant can import into their profile and import one as a work experience, matching the in-app "Add from bookings" feature.
​


Release Version 11.82

2026-10-16
​
​API
• Subcontractor groups are now API-manageable — You can now create, edit and delete subcontractor groups through the API.
• Customer contact LinkedIn URL is preserved — Updating a customer contact no longer erases its stored LinkedIn URL.


Release Version 11.80

2026-10-12


API performance gets a boost, CV language levels snap to attention, and the backend tidies up its webhook delivery records.
​
​API
• Permission updates for non-employee company users — The POST /v0.1/companies/{companyId}/permissions endpoint now allows permission changes when the acting company user is not an employee.
• CV import completion on user removal — When a user is removed or deactivated while their CV is being parsed, the import now completes with status Failed and reason "The profile could not be created for the user", instead of staying in progress.
• Faster project endpoint — GET /v0.1/companies/{companyId}/projects/{id} responds faster and now returns roles in ascending id order.
• Faster user profile endpoint — GET /v0.1/companies/{companyId}/users/{companyUserId}/profile responds faster.
• Faster single user fetches — Retrieving a single user is now much faster for users with many resumes, teams or customer managers.
• Project search returns more fields — POST /v0.1/companies/{companyId}/projects/search now returns estimated value, currency, probability, estimated close date, state, pipeline, stage and sales managers on each row.


Release Version 11.79

2026-10-09


Case studies get smarter grouping and duplication, the AI assistant speaks more clearly, and a bunch of profile fields now stay in sync across your CVs.


​API
• Event error reporting simplified — Editing or deleting an event with an unknown id now returns a single "event does not exist" error instead of also reporting a permission error.
• OpenAPI documentation shows access requirements — The OpenAPI document now displays the required module and access level for every operation, including those with extra remarks.


Release Version 11.78

2026-10-07
​
​API
• Updating a project with PUT no longer adds a duplicate state-history entry when the project state is unchanged


Release Version 11.77

2026-10-05
​
​API
​
• Discussions are now available through the external API. Start a discussion on a customer, project, employee, subcontractor, candidate, role, customer contact or candidate user, reply to it, read the whole thread, edit or delete posts, and search discussions and their posts across every kind of entity you have access to read.
• Event comment texts and event assignee lists are now documented as always present in responses. Event titles and comment texts in create/edit requests were already required. All other event fields stay nullable.
• Candidate, attachment, pipeline and recruitment source responses now mark always-present fields as non-nullable and required. Candidate, invite, attachment and skill creation now document their mandatory fields as required; they were already required, but the error message may change. An invite without an e-mail now reports only the missing e-mail; "Candidate already has a Cinode account" is reported once the e-mail is sent.
• Customer, domain, manager and attachment responses now mark always-present fields as non-nullable and required. Customer custom field values are documented as always present (possibly empty). The domain name is now documented as required on create and edit; it was already required, but the error message may change.
• Search responses now mark their paging and result lists, and skill search hits' skills, as non-nullable and required. All search filters stay optional.
• User, subcontractor, attachment and role-match responses now mark always-present fields, such as first name, e-mail and time zone, as non-nullable and required. User edit and permission edits now document their mandatory fields as required; they were already required, but the 400 response changes. The error keys change from Email, Firstname, Lastname and AccessLevels to email, firstName, lastName and permissions, and the message text changes too.
• Profile responses now mark their translation and block lists, and language branches, as non-nullable and required. The commitment description is now documented as required; it already was, but the error message may change.
• Profile skill, extra skill, reference, training and work experience responses now mark their translation lists, the skill change history and work-experience skills as non-nullable and required. Reference names and the training title are now documented as required; they already were, but the error message may change.

[10:51 AM]

• Role (project assignment) responses now mark their title, seo id and prospect, pinned user and skill lists as non-nullable and required. The same applies to announcement titles, role search titles and the subcontractor response's attachment list. Role search results document their prospect list as always present (possibly empty). Request models are unchanged, apart from titles and skill names that were already required.
• Project, pipeline, state reason, project manager, attachment and reference responses now mark always-present fields, such as title, seo id and the project's lists, as non-nullable and required. Project events and custom field values are documented as always present (possibly empty). The uri attachment title and reference text are now documented as required; they already were, but the error message may change.
• New endpoint POST /v0.1/companies/{companyId}/subcontractors/search to search subcontractors with paging, sorting and filters on name, internal/external id, company identifier, groups, tags, dates and custom fields.
• Event search (POST /v0.1/companies/{companyId}/events/search) now sorts by pageAndSortBy.sortBy for created date, updated date, last touch date and id, in both directions.
• Subcontractor role members now include groupId, the subcontractor group of the booking. Send it back when you edit the booking to keep the group.


Release Version 11.75

2026-09-29
​
​API
​
• POST /v0.1/companies/{companyId}/events/search now only returns events of the entity types your access level permits. Leaving entityTypes empty searches every entity type you can see, instead of every entity type in the company.
• When the candidate query fails, the candidate list and candidate search endpoints now return an error instead of an empty result.


Release Version 11.74

2026-09-22
​
​API
​
• The roles search (POST /roles) accepts createdAt and updatedAt date intervals, and roles now return their createdDateTime and updatedDateTime. Retrieving every role created or changed in a period is now a single request.
• Event comments can now be created, updated and deleted through the API, for candidate, customer, employee, subcontractor and project events. Only the author of a comment can update it. Comments now also return the author's name.
• Event comments can now be searched across the whole company with POST /v0.1/companies/{companyId}/events/comments/search, filtered by event, entity type, author, free text and creation date. Results include the event and entity each comment belongs to.
• The Employer field is now optional when you create or update a work experience through the external API. This matches the behaviour of the internal API, which never required it.


Release Version 11.73

2026-09-14
​
​API Changes


• Added POST /v0.1/companies/{companyId}/projects/{projectId}/move to move a project to another customer and return the resulting moved project, reusing existing move validation and authorization rules.


Release Version 11.68

2026-08-26


​API Changes

  • The API can now add, list and remove individual reference persons and contact persons on a project reference case, via /v0.1/companies/{companyId}/projects/{projectId}/references/{referenceId}/persons/references and .../persons/contacts, instead of replacing the whole set through the reference itself.


Release Version 11.66

2026-08-13

API Changes

  • Faster profile endpoints: Improved response times and reduced server CPU load for the public API endpoints GET .../users/{id}/profiles and GET .../users/{id}/profile.

  • Faster project roles: Improved response times and reduced server load for the public API endpoint GET .../projects/{projectId}/roles/{id}.

  • Manage tags via the external API: You can now attach and detach tags to and from a tag type using POST and DELETE on /v0.2/companies/{companyId}/tag-types/{tagTypeId}/tags/{tagId}.


Release Version 11.64

2026-08-10

API Changes

  • Flows users can now configure deployed integrations that aren’t customer-deployable, and avatar handling is more resilient to variations in Prismatic responses.

  • Added webhooks for company team create, update, and delete events.

  • Added webhooks for role satisfaction updates.

  • Added webhooks for company events such as meetings, notes, and tasks across customers, projects, and company users.

  • Search and toggle endpoints now handle empty request bodies gracefully, returning default results instead of a 500 error.

  • GET /teams now also returns created, updated, internalIdentification, corporateIdentityNumber, costCenter, location, and locationId, bringing it in line with the detail endpoint.

  • Project and customer GET endpoints now include custom field values.


Release Version 11.59

2026-06-16

API Changes

  • Added API endpoints to list, add, and remove customer contacts connected to projects.

  • Project role API responses now include satisfaction data.

  • The external API now returns timezoneId on CompanyUserModel and CompanyUserFullModel.

  • Added a new API endpoint for finding open roles that semantically match a user's skills (available for companies with semantic matching preview enabled).

  • Employees created through the external API without an availability percentage are now created at 100%, matching the behavior of the web app and SCIM provisioning.

  • Project assignment webhooks now include CompanyUserType for assigned and prospect members, making it easier to identify employees, subcontractors, and candidates.

  • Company Managers can now access the weekly utilization endpoint. Monetary values remain visible to administrators only.


Release Version 11.54

2026-05-19

API Changes

  • Added API endpoints for assigning and removing project managers and sales managers on projects.


Release Version 11.53

2026-05-18

API Changes

  • Added API endpoint for attaching links (URIs) to projects: POST /v0.1/companies/{companyId}/projects/{id}/attachments/uri

  • Added external API endpoint for uploading file attachments to customers: POST /v0.1/companies/{companyId}/customers/{id}/attachments

  • Added external API endpoints (v0.2) for getting, adding, and removing tags on customer contacts.


Release Version 11.52

2026-05-11

API Changes

  • Added v0.2 external API endpoints for reading and removing company user tags, and aligned company user tag creation behavior with customer tags.


Release Version 11.51

2026-05-06

API Changes
• New endpoint: POST /v0.2/companies/{companyId}/users/{companyUserId}/tags
• Set tags on a company user in a single request
• External API: Subcontractor response model now includes gender (aligned with existing endpoints)


Release Version 11.41

2026-03-26

API Changes

  • Improved AI-generated results in several text-based features by upgrading the default chat model to gpt-5-mini and updating the affected services to the current API.


Release Version 11.40

2026-03-19

API Changes

  • Profile block items in the external API now include audit fields like createdDateTime, updatedDateTime, createdBy, and updatedBy. More transparency, less guesswork.

  • Also fixed an issue where some updates (Training, Reference, Language, Presentation) weren’t properly saving who changed what and when. Time now behaves as expected.


Release Version 11.39

2026-03-17

API Changes

  • Added support for customer integrations to use Role Matching capabilities — now covering employees, subcontractors, candidates, and partner networks.


Release Version 11.36

2026-02-24


​API Changes

  • Customer domain management endpoints added to the external API with full CRUD support, HATEOAS links, and thorough integration tests. Ready for prime time.


Release Version 11.34

2026-02-13

API Changes

  • Search API: Customers can now be filtered by tags using the tags and tagOperator parameters. Choose between ANY or ALL matching depending on how picky you’re feeling.


Release Version 11.33

2026-02-09

API Changes

  • You can now explicitly set ProfileTranslationId when updating a CompanyUserProfileSkill via PUT.


Release Version 11.29

2026-01-28


​Features

  • API Accounts: When adding an API account, you’ll now also get the encoded credentials ready for easy copy-paste. Because typing is overrated.

API Changes

  • Added more documentation to the external API /_whoami endpoint. It now explains itself a bit better.


Release Version 11.28

2026-01-21

API

  • Customer search API upgrade: Added externalId and externalIdOperator filters, with support for equals, contains, startsWith, and endsWith. More flexibility, fewer workarounds, happier integrations.


Release Version 11.26

2026-01-26

API & Webhooks


Added internal and external IDs to absence data.
New AvailabilityPercent property when adding company users.
Updated skill-set routes for adding and removing skills (cleaner in, cleaner out).

  • Webhooks now fire when project managers or sales managers are added, removed, or updated—no more guessing.


Release Version 11.25

2026-01-13

API changes

  • Improved performance for the CompanyUsersExtended external API endpoint. Same data, faster delivery.


Release Version 11.24

2025-01-09
​

API changes

  • External API: Added a Discriminatorproperty to ProjectAssignmentMemberModel.



Release Version 11.23

2025-12-15

API Changes

  • New POST / PUT / DELETE endpoints for project references

  • More control over project references, now fully API-accessible.

  • Support for setting Google Project IDs

  • Projects and Google IDs can now shake hands properly via the API.


Release Version 11.22

2025-12-09

API

  • API Support for pinning and unpinning users on roles. (Now your roles can stay organized… or unorganized. Your call!)


Release Version 11.21

2025-12-03


​API

  • Added AI-powered skill generation for roles to the API. Robots helping you describe humans—what a time to be alive.

  • Added two new endpoints for listing templates and retrieving template details.

  • Fixed a security issue where non-admin users could manage skill sets via the external API. That’s now fully admin-only, as it should be.


Release Version 11.15

2025-11-06

API

  • Added the ability to filter company users by tags in the Search Company User endpoint. More precise searches = fewer scroll marathons.


Release Version 10.96

2025-08-18

API

  • The Resumes API now supports multiple blocks of the same type. Because sometimes one block just isn’t enough.


Release Version 10.94

2025-08-12


​API

  • Added endpoints to the External API for adding and deleting keyword synonyms in a skill set.

  • Added an endpoint to the External API for creating skill sets.


Release Version 10.87

2025-06-02

API

  • The createdBy and updatedBy fields have been added to the CompanyUserProfile. Because knowing who did what is half the battle.


Release Version 10.84

2025-05-26


​API

  • We’ve added lastTouchDateTime to project search results.

  • Projects now remember where they came from! We’re tracking their origin when you move or copy them—no more lost project identities.

  • Endpoint added to send welcome email to users and subcontractors


Release Version 10.83

2025-05-16


​API

  • Added ProjectPipelineStageHistories to the Project entity in the external API. More project history, now just an API call away.


Release Version 10.76

2025-04-11


​API

  • You can now manage tag-types via the API. Tag away, tag enthusiasts!

  • New endpoints to convert employees to subcontractors. Because sometimes roles evolve—and now your data can too.
    ​


Release Version 10.72

2025-03-19
​

API

  • SearchCompanyCandidate now supports filtering and sorting by LastTouchDate. Because finding the latest interactions should be effortless.

  • ExternalId can now be set on CompanyUserEmployee, CompanyUserSubcontractor, and CompanyCustomer using the API. More flexibility, more control.


Release Version 10.71

2025-03-13
​

API

  • Company-wide control over Personal API Accounts: Need to turn them off for everyone? Now you can. Power move. 💪


Release Version 10.65

2025-03-06
​

API

  • ParentTeamId added – TeamBaseModel now includes ParentTeamId. More family structure for your teams!

  • Bugfix: Currency matters – External API no longer errors out if you forget to send in currencyId. (But, you know, still send it.)


Release Version 10.65

2025-02-27
​

API

  • New company address endpoints – CRUD away!

  • New endpoint for subcontractor role requests – Now supports creating responses and attaching files. Because paperwork is digital now.


Release Version 10.64

2025-02-19

API

  • Consistency is key. We’re aligning role visibility rules across multiple pages. No more surprises.

  • More fields, more power. Additional fields are now exposed in the API. Data lovers, rejoice!


Release Version 10.60

2025-02-10

API

  • Unified authentication for API and APP—because who doesn't love a little consistency in their life?


Release Version 10.55

2025-01-30

API

  • Locking it down. Added authorization checks on API endpoints for absence, search, teams, skills, and company users. Because security is not a *maybe*.


Release version 10.51

2025-01-21

API

  • Profile performance boost: We sped up the API for fetching profiles. (No need to wait longer than you wait for your coffee.)


Release version 10.49

2025-01-09

​API

  • Enhanced the project search endpoint with a created and updated timestamp. Now you can track time like a pro.

  • Fixed a pesky bug with isCurrent mapping in the work experience API. It now behaves properly—just like your ideal work history.

  • API now supports management of your company’s training catalogs. Train smarter, not harder.

  • Added filters for EstimatedCloseDate, LastTouchDate, CreatedDate, ProjectManagers, Tags, and Teams in the SearchProject endpoint. The power to find exactly what you’re looking for is in your hands.


Release version 10.46

2025-01-03

​API

  • The RecruitmentSourceId has been added to the CompanyCandidate return model in the external API. A little extra data never hurts.


Release Version 10.38

2024-11-21

API

  • Added a PUT subcontractor endpoint. Updating subcontractor data has never been so PUT-together.


Release Version 10.36

2024-11-14

API

  • Added a "Delete Team" endpoint to the external API. Say goodbye to old teams with ease.


Release Version 10.30 & 10.31

2024-10-24

API

  • Added a shiny new endpoint to the external API to get all skill sets for a company. Skills, skills everywhere!


Release Version 10.28

2024-10-21

API / Webhooks:

  • Updated and createddatetime added to the CompanyUserProfileTraining endpoint in the external API.

  • Webhooks now notify you when employees are added or removed from teams. Because you like to stay in the loop, right?

  • Added a shiny new Utilization Weekly for 6 Months data endpoint to the external API.


Did this answer your question?