Skip to main content

2026-11-17

  • Introduced ObjectIDs, the new preferred identifier system. Old IDs keep working, but will be deprecated in the future.
    • Every existing ID field in input or result types now has an ObjectID counterpart (e.g. boardOid next to boardId). Newly added APIs going forward, will only include ObjectIDs.
    • Jobs and roles get their ObjectID when created as drafts, and keep it after publishing.
    • Added aliases: custom identifiers for any object, managed with companyOidAliases, setOidAliases and deleteOidAliases.
  • Webhooks are out of the experimental phase, and can now be set up and managed by admins in the admin web app.
    • New events: JobUpdate, JobRoleUpdate, CrewBookingUpdate and CrewStatusUpdate.
    • Payloads now include event_id (the same for every retry of an event) and delivery_timestamp. Event data now includes ObjectIDs (with the same format as in GraphQL).
    • Requests are signed with Ed25519 or RSA keys configured in the admin web app. Legacy HMAC SHA256 signing has been removed: webhooks that used it are sent unsigned until signing is configured again.
  • Companies with API access can now invite developers under Custom admin role with Allow Developer Access permission. Such accounts can only access API and Webhooks configuration pages, and do not take up an admin seat.
  • Added payment data queries: paymentReports, paymentReportItems and crewInvoices.
  • Added role creation, update and deletion to the updateJobs mutation (rolesCreate, rolesUpdate, rolesDelete).
  • Added labels, image and coordinates inputs to the createJobs and updateJobs mutations, and a coordinates field to Job.
  • Added crew note management to the updateCompanyCrew mutation (notesCreate, notesUpdate, notesDelete), and a notes field to CompanyCrew returned by companyCrewOne. The alerts field is deprecated in favour of notes.
  • Added a board filter to the companyJobs query and a crew filter to the companyCrewJobs query.
  • Deprecated Role.labels in favour of Role.requirements.
  • Removed support for legacy Auth0 access tokens. Only tokens issued for API keys, registered in the admin web app are accepted.
  • Fixed roleTypes on the updateCompanyCrew mutation silently dropping role types it did not recognise. Role type names now match ignoring case and surrounding whitespace, and mutation fails if matching role type wasn't found.