Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

API design: Self-service: Install Apple App Store apps on macOS #22102

Merged
merged 92 commits into from
Oct 1, 2024

Conversation

marko-lisica
Copy link
Member

fleet-release
fleet-release previously approved these changes Sep 24, 2024
fleet-release
fleet-release previously approved these changes Sep 24, 2024
Comment on lines +544 to +547
- [Batch-apply packages](#batch-apply-packages)
- [Batch-apply App Store apps](#batch-apply-app-store-apps)
- [Get token to download package](#get-token-to-download-package)
- [Download package using a token](#download-package-using-a-token)
Copy link
Member

@noahtalerman noahtalerman Sep 24, 2024

Choose a reason for hiding this comment

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

@lucasmrod when we merged in reference docs for the 4.57 release, it looks like the batch-apply endpoints got moved to the REST API docs instead of the contributors docs (see here).

I moved them back. When you get the chance, can you please check to see if these changes look right?

Also, I moved the download endpoints here b/c I think they're only for the Fleet UI to use (#21341). The best practice download endpoint for the IT admin to use in automations is here: https://fleetdm.com/docs/rest-api/rest-api#download-package

Copy link
Member

Choose a reason for hiding this comment

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

I'm super confused. It seems we deliberately moved them from API for contributors to REST API? (here).

Copy link
Member

@noahtalerman noahtalerman Sep 24, 2024

Choose a reason for hiding this comment

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

Hmm, I see. I think up to @rachaelshaw.

Rachael re your comment here, are we changing our philosophy? That is, endpoints that fleetctl uses (not best practice for automation use cases) live in API for contributors.

Copy link
Member

Choose a reason for hiding this comment

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

@noahtalerman nope, I was just confused; I saw Luke's review comment about the other /app_store_apps endpoints being the REST API and was like "oh yeah this looks like it fits with those" — I should have double-checked how this endpoint was being used first!

Copy link
Member

Choose a reason for hiding this comment

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

Got it!

It seems we deliberately moved them from API for contributors to REST API?

@lucasmrod just following up here to say we goofed (which happens). We want the batch-apply endpoints to live in the API for contributors docs.

Copy link
Member

Choose a reason for hiding this comment

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

@rachaelshaw I think we're ready for final review/merge.

fleet-release
fleet-release previously approved these changes Sep 27, 2024
fleet-release
fleet-release previously approved these changes Sep 27, 2024
@noahtalerman
Copy link
Member

Hey @lukeheath when you get the chance, can you please give this PR a review?

Waiting to close the associated user story until this PR is merged.

@noahtalerman noahtalerman merged commit c545495 into main Oct 1, 2024
5 checks passed
@noahtalerman noahtalerman deleted the vpp-self-service-api-design branch October 1, 2024 21:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

6 participants