[API updates] Fleet Desktop > Self-service: categories & updates

[eugkuo]

In support of #27245

[iansltx]

IIRC we decided that a software title could belong to multiple categories?

Also, we should confirm whether/how categories vary, as that will determine where this gets put. Where it is right now would mean that categories are set per-team, which is probably fine, and we'd also need this indicated on app store apps, which is a little awkward from an API perspective as there are two places to look for the values but not the end of the world.

Semi-finally, are we using slugs for categories (like you're doing here) or display names? If slugs, how are we mapping to display names? Thinking we need a GET endpoint (/fleet/software/categories) for this list. We'll also want filtering by category (any-of search via comma-delimited list) on /fleet/device/{token}/software . Filtering by category would require self_service to be set since we have undefined/unclear behavior otherwise.

Finally, we may want to add category filtering on the /fleet/software/titles endpoint. If we did this for we would want to require self_service or available_for_install to be set in order to filter by category for similar reasons to requiring self_service on the device endpoint.

[rachaelshaw]

Couple things I think we should add for clarity:

• It'd be nice to actually create the list of categories somewhere in the docs, and link to it in the parameter tables. (Is there a self-service guide we can add it to, and link there?)
• Are these case-sensitive? If so, we should specify that.

[iansltx]

@rachaelshaw We do have a self-service guide.

These would not be case-sensitive since we'd be matching = on name in the DB.