Render DFC collections in containers for v2 requests#14374
Open
mkllnk wants to merge 6 commits into
Open
Conversation
This is a breaking change because we remove the Person (current user) from the response. Including relationships to the authenticated person was an early concept of the DFC standard but has been abandoned. The person served as a container for the groups on this endpoint. And in v1 we don't have a replacement for it. We just list the groups. But in v2 we have the container containing the groups. I'm not aware of any integrations using this endpoint.
This is another breaking change. Well, our implementations of importing a catalog just look for catalog items in the graph and don't use the enterprise at all. So it doesn't break OFN. I don't know if there are any platforms out there importing from OFN. If we didn't want to change v1 then we would need to distinguish between versions within each controller. It would be nice to know if this would break anything or not. We don't know who is consuming our API and in which way...
mkllnk
added
the
api changes
rioug
reviewed
Jun 9, 2026
dacook
approved these changes
Jun 15, 2026
dacook
left a comment
dacook
left a comment
Member
There was a problem hiding this comment.
Great to see the multi-versioning coming together, well done!
Should we add the label "minor breaking change"?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ℹ️ Use Clockify code
#13323 Connecting Farms and Marketswhile working on this.What? Why?
With these changes, all endpoints will support rendering in DFC v2 format as JSON-LD. The data content is not migrated to the new models yet. Enterprises are not send as Organization yet (coming soon). But everything is sent with the newest context and using containers where required. LDP Containers are required in DFC v2 when publishing lists of resources like our index actions do.
What should we test?
Release notes
Changelog Category (reviewers may add a label for the release notes):
The title of the pull request will be included in the release notes.
Dependencies
Documentation updates