Proto commits in cs3org/cs3apis

These commits are when the Protocol Buffers files have changed: (only the last 100 relevant commits are shown)

2026-06-22

feat(gateway): add SetImmutable/UnsetImmutable RPCs (#275) Follow-up to cs3org/cs3apis#272 which added SetImmutable/UnsetImmutable to the StorageProvider. This exposes the same RPCs on the Gateway so that clients (like the Graph API in OpenCloud) can call them through the gateway without needing direct StorageProvider access. - SetImmutable: freeze files (irreversible) or protect containers (reversible) - UnsetImmutable: remove protection from containers (frozen files stay frozen) Co-authored-by: flash <flash7777>

The documentation is generated from this commit.

2026-06-15

OCM: implement new webapp protocol (#274) * Add a hidden optional flag for OCM received shares Symmetric to ReceivedShare.hidden * OCM: implement new webapp protocol * Align OCM webdav protocol to use resource permissions

2026-06-04

feat: add container-specific permissions and immutable flag (#272) * feat: add container-specific permissions and immutable flag Add two new permission fields to ResourcePermissions: - delete_container (field 21): controls whether containers/directories can be deleted, independent of the file delete permission - move_container (field 22): controls whether containers/directories can be moved or renamed, independent of the file move permission Add immutable field (field 20) to ResourceInfo: - When set, prevents modification, deletion, moving or renaming - For containers, also prevents creation of new children - Existing non-immutable children can still be modified These additions enable DMS use cases such as: - File plan (Aktenplan) structure protection - Retention/legal hold at the resource level - Granular permission control separating file and directory operations The new permission fields are backward compatible: when not explicitly set, implementations should fall back to the existing delete/move permissions for containers. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: add proposal for container permissions and immutable resources Add proposal document explaining the motivation, specification, and backward compatibility for the new delete_container, move_container, and immutable fields. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: add immutable attribute and SetImmutable/UnsetImmutable RPCs - Add immutable field (20) to ResourceInfo as persistent xattr attribute - Add SetImmutable/UnsetImmutable RPCs to ProviderAPI - Update proposal to clarify distinction between attribute (immutable) and action (SetImmutable), and how it differs from locks and status * docs: clarify immutable semantics for files vs containers Refine the immutable field comment to distinguish: - File (freeze): final, irreversible, no modification - Container (protect): structure fixed, reversible by managers - Self vs. parent rule: object is immutable if own or parent attribute is set Add immutable-overview.md as reference specification. No structural changes to the proto definition. * feat: add set_immutable_file and set_immutable_container permissions Add two permission fields to control who may set the immutable attribute, separated by resource type: - set_immutable_file (field 23): freeze files (irreversible) - set_immutable_container (field 24): protect/unprotect containers (reversible by managers) This separation allows roles to grant container protection rights without granting the ability to irreversibly freeze files. * docs: update immutable-overview.md with final specification --------- Co-authored-by: flash <flash7777> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-05-28

ocm: add TRANSFERRING share state (#273)

2026-05-21

OCM: added an optional destination on ReceivedShare (#271)

2026-05-05

implement labels API (#268)

2026-04-29

implement labels API

2026-04-24

Replace the favorites API (add / remove favorite) with a more generic labels API (#267)

2026-04-23

Replace the favorites API (add / remove favorite) with a more generic labels API

2026-04-22

appprovider: add forced_view_mode_reason to response (#266)

appprovider: add forced_view_mode_reason to response

Add new filter type for Spaceroots to share requests (#265) To be able just list shared spaces or everything less but spaces the TYPE_SPACE_ROOT filter can be used.

2026-04-08

Add status to User (#264) * Add status to User * Make sure the default UserStatus is ACTIVE, as it may not be set, without going for an `optional` field

2026-04-07

Make sure the default UserStatus is ACTIVE, as it may not be set, without going for an `optional` field

Add status to User

Updated Copyright

Add "Tenant" service for resolving externally managed tenant IDs (#263) * Add "Tenant" service for resolving externally managed tenant IDs The service currently provides two RPCs: - GetTenant: to lookup a tenant by it's unique ID (i.e. the ID that is available on the `UserId` object) - GetTenantByClaim: to lookup a tenant by name or some externally managed Id (e.g. for systems where there needs to be some mapping performed between the Id maintained on the `UserId` and an Id that is managed by some "external" system. Co-authored-by: Christian Richter <c.richter@opencloud.eu> * Apply suggestions from code review Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch> --------- Co-authored-by: Christian Richter <c.richter@opencloud.eu> Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch>

Update UserID (#261) Add external_identities to keep track of multiple identities of the same user on different systems (e.g. same e-mail on multiple SSO portals).

Update UserID Add external_identities to keep track of multiple identities of the same user on different systems (e.g. same e-mail on multiple SSO portals).

2026-04-02

add TYPE_GRANTEE to sharing filter, to list shares to a specific grantee (#262)

2026-04-01

add TYPE_GRANTEE to sharing filter, to list shares to a specific grantee

2026-03-10

Add endpoints for adding and removing favorites (#260)

2026-01-30

OCM: drop datatx protocol, deprecate 'code' and add 'access_types' (#259) * OCM: removed datatx protocol, deprecated 'code' and added 'access_type' * Added OCM version where `code` was deprecated

2025-12-11

Related to previous commit, add EMBEDDED view mode to OpenInAppRequest API

Add VIEW_MODE_EMBEDDED to resource view modes (#258)

Add VIEW_MODE_EMBEDDED to resource view modes

2025-12-10

OCM: Separate storage resource from shared resource and add filters on received shares (#257) * OCM: Add filters on received shares * Rephrased some comments * Removed redundant comment * rename of share_type * Update fields in OCM ReceivedShare --------- Co-authored-by: Rasmus Welander <rasmus.oscar.welander@cern.ch> Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch>

2025-11-11

OCM: Add embedded protocol (#256) Co-authored-by: Rasmus Welander <rasmus.oscar.welander@cern.ch>

Introduced the Incoming OCM API (#253) * Introduced the Incoming OCM API. Fixes #150. This is a one-on-one replacement of the so-called "Core OCM" API, which is now deprecated and will be removed in a later change. * Added corresponding gateway APIs

2025-10-14

Added new gateway endpoint to list existing OCM shares (#255)

2025-09-26

Add support for generic filters in FindUsers and FindGroups (#254) * Add support for generic filters in FindUsers and FindGroups * Use plural for repeated fields to conform to all other APIs

2025-09-08

Revert "Add filter to ListStorageSpacesRequest to filter on Space ID (#251)" (#252) This reverts commit 2226c7770d70b65fcde83271b03a37ea71bfbf5f.

Revert "Add filter to ListStorageSpacesRequest to filter on Space ID (#251)" This reverts commit 2226c7770d70b65fcde83271b03a37ea71bfbf5f.

Add filter to ListStorageSpacesRequest to filter on Space ID (#251)

Add filter to ListStorageSpacesRequest to filter on Space ID

Updated copyright

Add permissions to StorageSpace definition (#250)

Added support for federated groups + added comments (#248)

Add permissions to StorageSpace definition

2025-09-02

Add support for filtering in FindUsers request (#247)

Add support for filtering in FindUsers request

2025-08-11

add thumbnail and readme IDs directly to space definition, add support (#246) for updating quota / name

add thumbnail and readme IDs directly to space definition, add support for updating quota / name

add thumbnail and readme IDs directly to space definition

Add UpdateField to UpdateStorageSpaceRequest (#245) * Add UpdateField to UpdateStorageSpaceRequest --------- Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch>

Fix loop in import

Extended comments

Update import

Add UpdateField to UpdateStorageSpaceRequest

2025-07-25

Add a tenant_id to UserIds (#244) Co-authored-by: Christian Richter <c.richter@opencloud.eu>

2025-07-03

add hasTrashedItems property to drive object (#242) Signed-off-by: Christian Richter <c.richter@opencloud.eu>

2025-06-26

add enum value for expiration to UpdateField of UpdateShareRequest to allow expiration times to to be updated (#241)

2025-05-08

Add options to build better java clients #235 (#236) https://github.com/cs3org/cs3apis/issues/235 Co-authored-by: Russe <Marc.Russe@gfi.ihk.de>

2025-02-18

Adapted OCM payloads to OCM 1.2 (#240)

2025-01-28

RFE: add Share.description and ReceivedShare.alias (#239)

2024-11-05

app provider: make the new product_name field required (#238)

Add lock to TouchFile + minor comments (#232) * [comment-only] mark OCM provider fields optional * Add optional lock to TouchFile

added a product property product_name to the app provider info, that could be used to handle product-specific differences (#237)

2024-09-06

[docs-only] added missing documentation

2024-08-02

Added more calls for listing all types of shares and include storage resource info (#231)

2024-07-24

add code 'too early' (#230)

2024-04-25

add remaining files and bytes in quota struct (#229) Co-authored-by: Gianmaria Del Monte <gianmaria.del.monte@cern.ch>

2024-04-24

add remaining files and bytes in quota struct

2024-04-03

Enhancement: added ListExistingReceivedShares to gateway API (#228)

2024-03-22

Further clarified scope of lock_id (#227) * Further clarified scope of lock_id in storage-related requests that do not alter the content of a file * minor fix * minor fix

2024-02-16

Clarified scope of lock_id in InitiateFileUploadRequest (#226) * Removed lock_id from InitiateFileUploadRequest * Reinstated lock_id and added comments for clarification

2023-12-19

Revert "Revert "Decouple spaces API from storage (#215)"" This reverts commit 0cb677950409c63993e335d63d8ad878b976f863.

Revert "Decouple spaces API from storage (#215)" This reverts commit 364619351dff807cf6a6a608e60e3135e66dc26d.

2023-12-05

add inner error to rpc status (#225)

2023-11-17

fix typo (#224)

2023-11-16

Build with buf (#216)

2023-10-25

Decouple spaces API from storage (#215)

2023-10-23

align owncloud master against main (#214) * add an expiration timestamp to grants The expiration timestamp limits the access of a share in time * add API changes to support share expiration * the code locked added * add hide share value Signed-off-by: Christian Richter <crichter@owncloud.com> * add documentation Signed-off-by: Christian Richter <crichter@owncloud.com> * incorporate requested changes Signed-off-by: Christian Richter <crichter@owncloud.com> * move hide flag to received share Signed-off-by: Christian Richter <crichter@owncloud.com> --------- Signed-off-by: Christian Richter <crichter@owncloud.com> Co-authored-by: David Christofas <dchristofas@owncloud.com> Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch> Co-authored-by: Michael Barz <mbarz@owncloud.com> Co-authored-by: Roman Perekhod <2403905@gmail.com>

2023-07-27

Added target to OpenInAppURL object (#212)

2023-06-06

Added/updated methods to manipulate OCM shares and invitees (#211)

2023-05-16

the code locked added (#210)

2023-05-08

Send remote share id on OCM share create (#209) * send remote share id on ocm share create * Update proto.lock

2023-04-27

Notifications (#208)

2023-03-31

Added viewMode on OCM webapp for completeness (#207)

2023-03-29

[docs-only] Add code comments to RestoreRecycleItemRequest (#148) * [docs-only] Add code comments to RestoreRecycleItemRequest See https://github.com/cs3org/reva/pull/2120 * key comes from ListRecycle --------- Co-authored-by: Michiel de Jong <michielbdejong@users.noreply.github.com>

Added comments to detail the mapping of OCM properties (#206)

2023-03-23

add an optional quota to the CreateHomeRequest (#203) Co-authored-by: David Christofas <dchristofas@owncloud.com>

2023-02-28

Get OCM share by token (#205)

2023-02-24

Get OCM share by token (#204)

2023-02-21

Add ResourceType field in ReceivedShare (#202)

2023-02-20

add endpoint to list all the valid invite tokens generated by the user (#201)

2023-02-14

Align OCM sharing APIs to new specs, add missing properties (#199) * rework of ocm in cs3apis * defined ocm protocols * add opaque to protocols * add protocol fields to ocm share * splitted created share to received share * updated proto.lock * updated proto.lock * fixes for review * revert position of resource_id field in share message * update proto.lock * updated docs --------- Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch>

2023-02-09

Share expiration (#192) * add an expiration timestamp to grants The expiration timestamp limits the access of a share in time * add API changes to support share expiration --------- Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch> Co-authored-by: Michael Barz <mbarz@owncloud.com>

2023-02-07

Name change in module datatx: PullTransfer -> CreateTransfer (#195) * Name change in module datatx: PullTransfer -> CreateTransfer * Add share_id field to message CreateTransferRequest. --------- Co-authored-by: Antoon P <antoon@redblom.com> Co-authored-by: Giuseppe Lo Presti <giuseppe.lopresti@cern.ch>

2023-01-17

Add error codes to InviteAPIs (#198) * add error codes to InviteAPIs * add doc

add description when generating an invitation token (#197)

2023-01-16

Get initiator's info on AcceptInvite (#196) * get initiator's info from accept invite response * updated doc * add initiator's info in ForwardInvite response

2022-10-12

add new user type space owner (#187) * add new user type space owner Signed-off-by: Jörn Friedrich Dreyer <jfd@butonic.de> * Update cs3/identity/user/v1beta1/resources.proto Co-authored-by: Andre Duffeck <aduffeck@users.noreply.github.com> Signed-off-by: Jörn Friedrich Dreyer <jfd@butonic.de> Co-authored-by: Andre Duffeck <aduffeck@users.noreply.github.com>

2022-10-05

add more share filters (#181) Added share filters to filter shares by space id and by state

2022-10-04

Allow a public share to be used internally (#186) * Add internal flag to public shares * add docs

2022-09-30

add description in create public share request (#185)

2022-09-29

Add description to public share (#184)

add optional oldLock to RefreshLockRequest (#183)

2022-09-13

Continuation of cs3org/cs3apis#179 (#180)

2022-09-05

Added PREVIEW as an additional ViewMode for apps (#179)