Rate Limits
Service Account Roles are highly flexible, and may have a large scope of access. Rate limits will apply to the uniqueness of the Service Account itself, so please consider these variables when designing programmatic access to SmartThings Enterprise APIs.
How to read this table
The Enforced Rate Limit format below represents a duration, and is based on the ISO-8601 duration format.
| Description | Path | Enforced Rate Limit | Bucket |
|---|---|---|---|
| List Location Groups | /locationgroups | 1000 PT1m | principal |
| Create Loccation Group | /locationgroups | 1000 PT1m | principal |
| Get Location Group by ID | /locationgroups/{locationGroupId} | 1000 PT1m | principal |
| Update Location Group | /locationgroups/{locationGroupId} | 1000 PT1m | principal |
| Delete Location Group | /locationgroups/{locationGroupId} | 1000 PT1m | principal |
| List Locations | /locations | 250 PT1m | principal |
| Create Location | /locations | 100 PT1m | principal |
| Get Location | /locations/{locationId} | 500 PT1m | principal |
| Update Location | /locations/{locationId} | 100 PT1m | principal |
| Delete Location | /locations/{locationId} | 100 PT1m | principal |
| List Rooms in Location | /locations/{locationId}/rooms | 250 PT1m | principal |
| Create Room | /locations/{locationId}/rooms | 100 PT1m | principal |
| Get Room | /locations/{locationId}/rooms/{roomId} | 250 PT1m | principal |
| Update Room | /locations/{locationId}/rooms/{roomId} | 100 PT1m | principal |
| Delete Room | /locations/{locationId}/rooms/{roomId} | 100 PT1m | principal |
| Get Devices in Room | /locations/{locationId}/rooms/{roomId}/devices | 350 PT1m | principal:roomId |
| Add Device to Room | /locations/{locationId}/rooms/{roomId}/devices | 350 PT1m | principal |
| Delete Device from Room | /locations/{locationId}/rooms/{roomId}/devices | 350 PT1m | principal |
| List Modes from Location | /locations/{locationId}/modes | 250 PT1m | principal |
| Create Mode | /locations/{locationId}/modes | 100 PT1m | principal |
| Get Mode | /locations/{locationId}/modes/{modeId} | 250 PT1m | principal |
| Delete Mode | /locations/{locationId}/modes/{modeId} | 100 PT1m | principal |
| Update Mode | /locations/{locationId}/modes/{modeId} | 100 PT1m | principal |
| Get current Mode of Location | /locations/{locationId}/modes/current | 250 PT1m | principal:locationId |
| Set current Mode of Location | /locations/{locationId}/modes/current | 100 PT1m | principal |
| List Devices | /devices | 1000 PT15m | principal |
| Get Device | /devices/{deviceId} | 400 PT15m | principal:deviceId |
| Update Device | /devices/{deviceId} | 400 PT15m | principal |
| Delete Device | /devices/{deviceId} | 400 PT15m | principal |
| Execute Device Command | /devices/{deviceId}/commands | 120 PT1m | principal |
| Get Device Health | /devices/{deviceId}/health | 40 PT1m | principal |
| Get Status of all Device Components | /devices/{deviceId}/status | 350 PT1m | principal |
| Get Status of a specific Device Component | /devices/{deviceId}/components/{componentId}/status | 350 PT1m | principal |
| Get Status of specific Capability | /devices/{deviceId}/components/{componentId}/capabilities/{capabilityId}/status | 350 PT1m | principal |
| Get Device Profile | /deviceprofiles/{deviceProfileId} | 120 PT1m | principal:deviceProfileId |
| List Capability versions | /capabilities/{capabilityId} | 2000 PT60S | principal |
| Get Capability | /capabilities/{capabilityId}/{capabilityVersion} | 2000 PT60S | principal |
| List locales for Capability | /capabilities/{capabilityId}/{capabilityVersion}/i18n | 360 PT60S | principal |
| Retrieve values for locale | /capabilities/{capabilityId}/{capabilityVersion}/i18n/{locale} | 360 PT60S | principal |
| List Installed Apps | /installedapps | 60 PT60S | principal |
| Delete Installed App | /installedapps/{installedAppId} | 60 PT60S | principal |
| List Rules | /rules | 60 PT60S | principal |
| Delete Rule | /rules/{ruleId} | 60 PT60S | principal |
| List Scenes | /scenes | 60 PT60S | principal |
| Delete Scene | /scenes/{sceneId} | 60 PT60S | principal |