In the provided API documentation, the usage examples suggest using -F parameters when making a POST request with curl: https://api.simplemdm.com/#create-8

However, I observed that the parameters can also be passed as part of the URL query string, and this approach works as expected.

This flexibility is not currently mentioned in the documentation, and it could help clarify the API usage for developers.

In the Sync Profiles API documentation here - https://api.simplemdm.com/#sync-profiles - there is a note indicating this specific endpoint is rate limited to 1 request per 30 seconds, and the header 'X-RateLimit-Reset' can be checked to see when the limit will be reset.

Can you please include specific examples in the documentation for this particular endpoint that demonstrate what the response headers will look like.

Additionally, for all API endpoints that have a rate limit, please indicate how the API will respond if the rate limit is hit and whether there will be a header 'X-RateLimit-Reset' value that indicates when that rate limit will be reset.

Providing clear documentation about these rate limits and how the API responds when they're hit will make it simpler for us developing implementations of the API and reduce the need to spam the API while testing.

Thanks Carl! To answer your questions:

Installed Apps:

GET https://a.simplemdm.com/api/v1/installed_apps/{INSTALLED_APP_ID}

Currently this method assumes that you have already called the List Installed Apps for a Device endpoint: GET https://a.simplemdm.com/api/v1/devices/{DEVICE_ID}/installed_apps

and are using one of the listed IDs to get just the specific installed app on that device.

Enrollments:

GET https://a.simplemdm.com/api/v1/enrollments

This returns a list of all enrollments in your account, excluding Automated Enrollments (eg. Group Enrollments and One-Time Enrollments).

Cloning Groups:

POST https://a.simplemdm.com/api/v1/device_groups/{DEVICE_GROUP_ID}/clone
This clones the group but there are currently no arguments supported, which is similar to the behavior if you clone a group in the admin interface. There is currently no API method to update a group name, but that would be a great feature request.

We will work on updating the documentation for these endpoints and ensuring they are consistently documented across the board.

Bumping this.

The https://api.simplemdm.com/#installed-apps documentation seems to be a bit ambiguous; it reads to me that you should be able to call these methods for a specific device, yet there is nothing that indicates you need to pass a device id parameter, for those methods.

The documentation for https://api.simplemdm.com/#enrollments is sparse - what is this method is actually doing? Are there supposed to be params to specify which enrollment to delete?

The documentation for https://api.simplemdm.com/#device-groups does not indicate if the clone method takes any parameters to set the name of the freshly cloned device group, does this endpoint actually even support changing the name of a device group after/during cloning? Is there an update method for this to modify an existing device group?

I have approx 40 votes left; if I could throw all 40 votes at this I would, but I can only throw 3 at it.