# SimpleMDM API

**Canonical:** https://apis.io/apis/simplemdm/simplemdm-api/  
**Provider:** SimpleMDM — https://apis.io/providers/simplemdm/  
**Base URL:** https://a.simplemdm.com  
**Documentation:** https://api.simplemdm.com

SimpleMDM API is one of 2 APIs that [SimpleMDM](https://apis.io/providers/simplemdm/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

SimpleMDM API as documented publicly: 71 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (60 of 71)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/account` | GET /api/v1/account |
| PATCH | `/api/v1/account` | Update account information. |
| GET | `/api/v1/apps` | GET /api/v1/apps |
| POST | `/api/v1/apps` | Create a new app. |
| GET | `/api/v1/apps/{appid}/managed_configs` | GET /api/v1/apps/{appId}/managed_configs |
| POST | `/api/v1/apps/{appid}/managed_configs` | POST /api/v1/apps/{appId}/managed_configs |
| GET | `/api/v1/assignment_groups` | GET /api/v1/assignment_groups |
| POST | `/api/v1/assignment_groups` | POST /api/v1/assignment_groups |
| PUT | `/api/v1/assignment_groups/{assignmentGroupId}/custom_attribute_values/{customAttributeId}` | Set value for assignment group |
| DELETE | `/api/v1/assignment_groups/{assignmentGroupId}/devices/{deviceId}` | Unassign device |
| DELETE | `/api/v1/assignment_groups/{assignmentgroupid}/device/{deviceid}` | DELETE /api/v1/assignment_groups/{assignmentGroupId}/device/{deviceId} |
| PUT | `/api/v1/custom_attribute_values/my_custom_attribute` | PUT /api/v1/custom_attribute_values/my_custom_attribute |
| GET | `/api/v1/custom_attributes` | GET /api/v1/custom_attributes |
| POST | `/api/v1/custom_attributes` | Define a new custom attribute for the account. |
| DELETE | `/api/v1/custom_attributes/{customAttributeId}` | Remove a custom attribute from the account. |
| GET | `/api/v1/custom_attributes/{customAttributeId}` | Retrieve one custom attribute. |
| PATCH | `/api/v1/custom_attributes/{customAttributeId}` | Update a custom attribute for the account. |
| GET | `/api/v1/custom_configuration_profiles` | GET /api/v1/custom_configuration_profiles |
| POST | `/api/v1/custom_configuration_profiles` | Create |
| DELETE | `/api/v1/custom_configuration_profiles/{profileId}` | Delete |
| PATCH | `/api/v1/custom_configuration_profiles/{profileId}` | Update |
| DELETE | `/api/v1/custom_configuration_profiles/{profileId}/device_groups/{deviceGroupId}` | Unassign from device group |
| POST | `/api/v1/custom_configuration_profiles/{profileId}/device_groups/{deviceGroupId}` | Assign to device group |
| DELETE | `/api/v1/custom_configuration_profiles/{profileId}/devices/{deviceId}` | Unassign from device |
| POST | `/api/v1/custom_configuration_profiles/{profileId}/devices/{deviceId}` | Assign to device |
| GET | `/api/v1/custom_configuration_profiles/{profileId}/download` | Download |
| GET | `/api/v1/custom_declarations` | GET /api/v1/custom_declarations |
| POST | `/api/v1/custom_declarations` | Create |
| DELETE | `/api/v1/custom_declarations/{profileId}` | Delete |
| PATCH | `/api/v1/custom_declarations/{profileId}` | Update |
| DELETE | `/api/v1/custom_declarations/{profileId}/devices/{deviceId}` | Unassign from device |
| POST | `/api/v1/custom_declarations/{profileId}/devices/{deviceId}` | Assign to device |
| GET | `/api/v1/custom_declarations/{profileId}/download` | Download |
| GET | `/api/v1/dep_servers` | GET /api/v1/dep_servers |
| GET | `/api/v1/dep_servers/{depServerId}` | Retrieve one |
| GET | `/api/v1/dep_servers/{depServerId}/dep_devices` | List DEP devices |
| GET | `/api/v1/dep_servers/{depServerId}/dep_devices/{depDeviceId}` | Retrieve one DEP device |
| POST | `/api/v1/dep_servers/{depServerId}/sync` | Sync with Apple |
| GET | `/api/v1/device_groups` | GET /api/v1/device_groups |
| GET | `/api/v1/device_groups/{deviceGroupId}/custom_attribute_values` | Get values for group |
| PUT | `/api/v1/device_groups/{deviceGroupId}/custom_attribute_values/{customAttributeName}` | Set value for device group |
| GET | `/api/v1/device_groups/{devicegroupid}` | GET /api/v1/device_groups/{deviceGroupId} |
| POST | `/api/v1/device_groups/{devicegroupid}/clone` | POST /api/v1/device_groups/{deviceGroupId}/clone |
| POST | `/api/v1/device_groups/{devicegroupid}/devices/{deviceid}` | POST /api/v1/device_groups/{deviceGroupId}/devices/{deviceId} |
| GET | `/api/v1/devices` | GET /api/v1/devices |
| POST | `/api/v1/devices` | Create |
| PUT | `/api/v1/devices/{deviceId}/custom_attribute_values/{customAttributeName}` | Set the value of a custom attribute for a device. |
| DELETE | `/api/v1/devices/{deviceId}/users/{userId}` | Delete User |
| GET | `/api/v1/enrollments` | GET /api/v1/enrollments |
| DELETE | `/api/v1/enrollments/2` | DELETE /api/v1/enrollments/2 |
| GET | `/api/v1/enrollments/2` | GET /api/v1/enrollments/2 |
| POST | `/api/v1/enrollments/2/invitiations` | POST /api/v1/enrollments/2/invitiations |
| DELETE | `/api/v1/installed_apps/{installedappid}` | DELETE /api/v1/installed_apps/{installedAppId} |
| GET | `/api/v1/installed_apps/{installedappid}` | GET /api/v1/installed_apps/{installedAppId} |
| POST | `/api/v1/installed_apps/{installedappid}/request_management` | POST /api/v1/installed_apps/{installedAppId}/request_management |
| POST | `/api/v1/installed_apps/{installedappid}/update` | POST /api/v1/installed_apps/{installedAppId}/update |
| GET | `/api/v1/logs` | GET /api/v1/logs |
| GET | `/api/v1/logs/964595dfd5be464a82cbb9019f55d82b` | GET /api/v1/logs/964595dfd5be464a82cbb9019f55d82b |
| GET | `/api/v1/profiles` | GET /api/v1/profiles |
| GET | `/api/v1/profiles/{profileid}` | GET /api/v1/profiles/{profileId} |

…and 11 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/simplemdm/openapi/_ae-authored/simplemdm-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/simplemdm/json-schema/simplemdm-post-api-v1-custom-configuration-profiles-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/simplemdm/json-schema/simplemdm-patch-api-v1-custom-configuration-profiles-profileid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/simplemdm/json-schema/simplemdm-post-api-v1-custom-declarations-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/simplemdm/json-schema/simplemdm-patch-api-v1-custom-declarations-profileid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/simplemdm/json-schema/simplemdm-post-api-v1-apps-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/simplemdm/json-schema/simplemdm-post-api-v1-apps-request-schema.json

## Other SimpleMDM APIs (1)

- [SimpleMDM API](https://apis.io/apis/simplemdm/simplemdm-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/simplemdm/simplemdm-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/simplemdm/.