Okapi Okapi

Zendesk API Legacy Custom Objects relationships API removal

Stopped workingSubscribe to Zendesk APIShare

On July 1, 2026, Zendesk fully removed legacy custom objects. Calls to /api/sunshine/relationships/* fail since that day. This follows a restriction from January 15, 2026, after which users could no longer create new legacy custom objects or relationships.


Calls it hits

  • /api/sunshine/relationships/*

What to use instead of these calls

Migrate to custom objects with lookup relationship fields (/api/v2/custom_objects/*). Moving to the new custom objects takes more than changing an endpoint, as it requires migrating the account's relationship types and records.

Moving to the new custom objects means migrating the account's relationship types and records.

In Zendesk API's words

Starting January 15, 2026, you will no longer be able to create new legacy custom objects or relationships. Zendesk will fully remove legacy custom objects in July 2026.

Zendesk API, Announcement

Facts

API
Zendesk API *.zendesk.com
Kind
Removal
Announced
July 7, 2025
Takes effect
July 1, 2026
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against Zendesk API's own pages

Questions

When does this change take effect?

Calls to /api/sunshine/relationships/* on Zendesk API stopped working on July 1, 2026.

What happens to calls after July 1, 2026?

They have failed since July 1, 2026.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from Zendesk API 7

  1. /api/v2/nps/*Removal Stopped working
  2. PUT /api/v2/users/me/mergeEndpoint removal Stopped working
  3. /api/v2/*Behaviour change Stopped working
  4. /api/sunshine/objects/*Removal Stopped working
  5. /api/v2/*Behaviour change Stops workingin 175 days
  6. No date GET /api/v2/apps/locations/{id}Endpoint removal Deprecated, no date
  7. No date POST /api/v2/oauth/tokensEndpoint removal Deprecated, no date

You fixed this one by hand.

Okapi opens the pull request with the fix before the next breaking change reaches your code.

Add to GitHub

Get notifications

Subscribe to Zendesk API

Hear about each breaking change Zendesk API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Zendesk API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.