Skip to content

Conversation

@nmanerikar
Copy link

@nmanerikar nmanerikar commented Jan 28, 2026

Document the new 'ownership' parameter in the listing requests for storages.


Note

Documents a new optional ownership query parameter for storage listing endpoints to filter by resource ownership.

  • Adds ownership to GET listings for datasets, key-value stores, and request queues (datasets.yaml, key-value-stores.yaml, request-queues.yaml)
  • Accepts ownedByMe or sharedWithMe; default remains all accessible resources

Written by Cursor Bugbot for commit ee02f2e. Configure here.

@nmanerikar nmanerikar requested review from raethlo and tobice January 28, 2026 16:43
@nmanerikar nmanerikar self-assigned this Jan 28, 2026
@nmanerikar nmanerikar added the t-core-services Issues with this label are in the ownership of the core services team. label Jan 28, 2026
@apify-service-account
Copy link

Preview for this PR was built for commit ee02f2e7 and is ready at https://pr-2208.preview.docs.apify.com!

- name: ownership
in: query
description: |
Filter by ownership. By default, all accessible datasets are returned.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this correspond to either of the possible values? Or is the default a third value, semantically?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Default is the absence of this parameter - all accessible datasets are returned when the ownership parameter is not included in the request. This behaviour will be changed shortly after communication with users - the absence of the ownership parameter will then start behaving the same as ownedByMe

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good, thanks for the explanation!

Comment on lines 66 to 71
schema:
type: string
enum:
- ownedByMe
- sharedWithMe
example: ownedByMe
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It'd be great to turn this into a reusable component

@apify-service-account
Copy link

Preview for this PR was built for commit 462f9f87 and is ready at https://pr-2208.preview.docs.apify.com!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-core-services Issues with this label are in the ownership of the core services team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants