The App Services API provides access to a set of REST-based resources that represent entities and collections. Your application can request a variety of operations on these resources. For example, your application can create, update, or query an entity or collection.
Your application makes requests through the API using HTTP methods such as GET, POST, PUT, and DELETE, and specifies the pertinent resource URL. For data operations on entities or collections, the URL begins with https://api.usergrid.com/. See Using the API for general usage information, such as how to construct an API request.
The following table lists and describes the entity resources accessible through the App Services API. Click on an entity for further details about the resource and its methods.
| Resource | Description |
|---|---|
| User | User entity |
| Group | Group entity |
| Role | Role entity |
| Activity | Activity entity |
| Application | Application entity |
| Assets | Asset entity |
| Device | Device entity |
| Events and counters | Event entity |
| Folder | Folder |
| Notifier, Receipt, and Notification | Push notification entities |
| General-purpose endpoints | User-defined entities |
Note that the App Services data structure is hierarchical. For every type of entity, there is a collection that contains all entities of that type. Collections belong to an application and applications belong to an organization.
Collections are automatically named using the plural form of the entity type. For example, an entity of type user is stored in the users root collection. This means that for each of the entity types listed above, a resource exists whose name is the plural form of that entity type.
