## Methods ### Action Methods

GET /management/orgs/{orgId}/activate

Activate an organization from a link provIded in an email notification.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __token__ () Activation token. (Specified in query). * __confirm_email__ () Send confirmation email or not. (Specified in query).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/orgs/{orgId}/reactivate

Reactivate an expired organization.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/users/resetpw

Initiate the reset of an admin user's password.

Parameters

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /management/users/resetpw

Complete the password reset through getting the newpassword and the old one for identification.

Parameters

* __ResetPWMsg__ ([ResetPWMsg](#resetpwmsg)) Parameters and value for the Captcha challenge, the admin user's response to the Captcha challenge, and the admin user's email address. (Specified in body).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/users/{userId}/activate

Activate an admin user from a link provIded in an email notification.

Parameters

* __userId__ (string) One of the user's identification which includes username, real name, email address or UUID. (Specified in path). * __token__ () Activation token's query statement. (Specified in query). * __confirm_email__ () Query statement of whether send confimation email or not. (Specified in query).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

PUT /management/users/{userId}/password

Update an admin user's password through getting the newpassword and the old one for identification.

Parameters

* __userId__ (string) One of the user's identification which includes username, real name, email address or UUID. (Specified in path). * __ResetPW__ ([ResetPW](#resetpw)) The user's old and new password. (Specified in body).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/users/{userId}/reactivate

Reactivate an expired admin user.

Parameters

* __userId__ (string) One of the user's identification which includes username, real name, email address or UUID. (Specified in path).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/users/{user}/password

Set a user's password or reset the user's existing password.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __username__ (string) The username of the user. (Specified in path). * __ResetPW__ ([ResetPW](#resetpw)) The user's old and new password. (Specified in body).

Responses

__200__ * Description: An array of complete messages. * Schema: [Action](#action) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### ActivityFeed Methods

GET /management/orgs/{orgId}/feed

Retrieve an organization's activity feed.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of the organization's ActivityFeed. * Schema: [ActivityFeed](#activityfeed) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/users/{userId}/feed

Retrieve an admin user's activity feed.

Parameters

* __userId__ (string) One of the user's identification which includes username, real name, email address or UUID. (Specified in path).

Responses

__200__ * Description: An array of user's activity * Schema: [ActivityFeed](#activityfeed) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/groups/{groupId}/activities

Create an activity to a specific group. In this case the activity is created in the activities collection and is accessible at the /activities endpoint to users who have the permission to read that endpoint. In addition, a relationship is established between the activity and the group, and because of that, the activity will appear in the group’s feed. The group 'owns' the activity. Also, the activity will be published in the feed of all users that are members of the group.

Parameters

Responses

__200__ * Description: An array of user's activity. * Schema: [ActivityFeed](#activityfeed) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/groups/{groupId}/feed

Get a group's feed through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of group's activity. * Schema: [ActivityFeed](#activityfeed) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/users/{userId}/activities

Create an activity in the activities collection.

Parameters

Responses

__200__ * Description: An array of user's activity. * Schema: [ActivityFeed](#activityfeed) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/users/{userId}/feed

Retrieve a user's feed through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of user's activity feed. * Schema: [ActivityFeed](#activityfeed) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### AppData Methods

GET /management/orgs/{orgId}/apps

Retrieve the applications in an organization through providing both Id of application and organization.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of retrieved application data. * Schema: [AppData](#appdata) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /management/orgs/{orgId}/apps/{appId}

Remove an application from an organization through providing both Id of application and organization.

Parameters

Responses

__200__ * Description: An array of deleted application info. * Schema: [AppData](#appdata) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Credential Methods

GET /management/orgs/{orgId}/apps/{appId}/credentials

Retrieve the client Id and client secret credentials for an application in an organization.

Parameters

Responses

__200__ * Description: An array of retrieved credentials info. * Schema: [Credential](#credential) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /management/orgs/{orgId}/apps/{appId}/credentials

Generate the client Id and client secret credentials for an application in an organization.

Parameters

Responses

__200__ * Description: An array of generated credentials info. * Schema: [Credential](#credential) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/orgs/{orgId}/credentials

Retrieve the credentials for an organization client.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of Credential * Schema: [Credential](#credential) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /management/orgs/{orgId}/credentials

Generate whole new credentials for an organization client.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of Credential * Schema: [Credential](#credential) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Devices Methods

GET /{orgId}/{appId}/{notificationId}/*/queue

Retrieve the list of devices associated with one or more notifications before the notifications are sent through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved device's info. * Schema: [Device](#device) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Entity Methods

GET /{orgId}/{appId}/users/{userId}/{relation}

Retrieve a user's collections or connections through query statement.

Parameters

Responses

__200__ * Description: An array of user's collections info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/{collectionId}

Retrieve collection through query statement.

Parameters

Responses

__200__ * Description: An array of retrieved collection's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

PUT /{orgId}/{appId}/{collectionId}

Update collection through query statement.

Parameters

Responses

__200__ * Description: An array of updated collection's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/{collectionId}/{entityId1}/{relation}/{entityId2}

Add an entity to a collection through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of added entity's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/{collectionId}/{entityId1}/{relation}/{entityId2}

Remove an entity from a collection through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of deleted entity's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/{collectionId}/{entityId}

Retrieve an entity through providing Id of application, organization, collection and entity.

Parameters

Responses

__200__ * Description: An array of retrieved entity's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

PUT /{orgId}/{appId}/{collectionId}/{entityId}

One or more properties can be updated with a single request.

Parameters

Responses

__200__ * Description: An array of updated entity's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/{collectionId}/{entityId}

Delete an entity from the collection.

Parameters

Responses

__200__ * Description: An array of deleted entity's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/{entitytype}

When a new entity is created, Usergrid will automatically create a corresponding collection if one does not already exist. The collection will automatically be named with the plural form of the entity type.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __entitytype__ (string) The entity type to create. (Specified in path). * __entityproperty__ ([CreateEntities](#createentities)) The properties of the entity. (Specified in body).

Responses

__200__ * Description: An array of created custom entity's info. * Schema: [Entity](#entity) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Event Methods

POST /{orgId}/{appId}/events

Create an event through providing both Id of organization and application.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __CreateEvent__ ([CreateEvent](#createevent)) The required property of the event. (Specified in body).

Responses

__200__ * Description: An array of created event's info. * Schema: [Event](#event) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Group Methods

POST /{orgId}/{appId}/groups

Create a new group through providing both Id of organization and application.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __groupproperty__ ([CreateGroup](#creategroup)) The property of the created group. (Specified in body).

Responses

__200__ * Description: An array of created group's info. * Schema: [Group](#group) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{org_Id}/{app_Id}/groups/{groupId}

Get a group through through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved group's info. * Schema: [Group](#group) __default__ * Description: Unexpected error. * Schema: [Error](#error)

PUT /{org_Id}/{app_Id}/groups/{groupId}

Update a group through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of updated group's info. * Schema: [Group](#group) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Notification Methods

PUT /my-org/sandbox/notifications/{notificationId}

Cancel sent notifications through providing the Id of the notification.

Parameters

* __notificationId__ (string) One of the notification's identification which includes name or uuid. (Specified in path). * __cancelMsg__ ([CancelMSG](#cancelmsg)) Indicete whether is canceled or not. (Specified in body).

Responses

__200__ * Description: An array of canceled notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/devices

Create notifications for user through targeting by location and providing all the identifications.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __notification__ ([CreateNotifications](#createnotifications)) These parameters are used when forming the notification portion of the request. (Specified in body). * __scheduleNotification__ ([ScheduleNotification](#schedulenotification)) To schedule a notification for a later time add the deliver parameter with a UNIX timestamp to the body of your request. (Specified in body). * __setExpiration__ ([SetExpiration](#setexpiration)) If a push service can't deliver a message to a device and needs to resend it you can set a notification to expire after a certain date/time. (Specified in body). * __queryStatement__ () The query statement of the location of the user. (Specified in query).

Responses

__200__ * Description: An array of created notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/devices/*/notifications

Create notifications for all devices. This request will target all device entities.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __notification__ ([CreateNotifications](#createnotifications)) These parameters are used when forming the notification portion of the request. (Specified in body). * __scheduleNotification__ ([ScheduleNotification](#schedulenotification)) To schedule a notification for a later time add the deliver parameter with a UNIX timestamp to the body of your request. (Specified in body). * __setExpiration__ ([SetExpiration](#setexpiration)) If a push service can't deliver a message to a device and needs to resend it you can set a notification to expire after a certain date/time. (Specified in body).

Responses

__200__ * Description: An array of created notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/devices/{deviceId}/notifications

Create notifications for a single device. This request will target a specific device entity.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __deviceId__ (string) One of the device's identification which includes name or uuid. (Specified in path). * __notification__ ([CreateNotifications](#createnotifications)) These parameters are used when forming the notification portion of the request. (Specified in body). * __scheduleNotification__ ([ScheduleNotification](#schedulenotification)) To schedule a notification for a later time add the deliver parameter with a UNIX timestamp to the body of your request. (Specified in body). * __setExpiration__ ([SetExpiration](#setexpiration)) If a push service can't deliver a message to a device and needs to resend it you can set a notification to expire after a certain date/time. (Specified in body).

Responses

__200__ * Description: An array of created notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/groups/{path}/notifications

Create notifications for a group. This request will target all users associated with a specific group entity.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __path__ (string) The path of the group. (Specified in path). * __notification__ ([CreateNotifications](#createnotifications)) These parameters are used when forming the notification portion of the request. (Specified in body). * __scheduleNotification__ ([ScheduleNotification](#schedulenotification)) To schedule a notification for a later time add the deliver parameter with a UNIX timestamp to the body of your request. (Specified in body). * __setExpiration__ ([SetExpiration](#setexpiration)) If a push service can't deliver a message to a device and needs to resend it you can set a notification to expire after a certain date/time. (Specified in body).

Responses

__200__ * Description: An array of created notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/notifications

Retrieve one or more notifications through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/notifications/{notificationId}

Remove unsent notifications through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of deleted notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/users/{userId}/notifications

Create notifications for a user. This request will target a specific user entity.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __userId-3__ (string) One of the user's identification which includes username or UUID. (Specified in path). * __notification__ ([CreateNotifications](#createnotifications)) These parameters are used when forming the notification portion of the request. (Specified in body). * __scheduleNotification__ ([ScheduleNotification](#schedulenotification)) To schedule a notification for a later time add the deliver parameter with a UNIX timestamp to the body of your request. (Specified in body). * __setExpiration__ ([SetExpiration](#setexpiration)) If a push service can't deliver a message to a device and needs to resend it you can set a notification to expire after a certain date/time. (Specified in body).

Responses

__200__ * Description: An array of created notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/{receiptId}/*/notifications

Retrieve notifications associated with one or more receipts through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved notification's info. * Schema: [Notification](#notification) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Organization Methods

POST /management/orgs

Create an organization through a form post.

Parameters

* __CreateOrg__ ([CreateOrg](#createorg)) A set of organization properties supplied through a form. (Specified in body).

Responses

__200__ * Description: An array of created Organization. * Schema: [Organization](#organization) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/orgs/{orgId}

Retrieve an organization given a specified UUID or username.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of created Organization. * Schema: [Organization](#organization) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Permission Methods

DELETE /{orgId}/{appId}/roles/{roleId}/permissions

Remove permissions from a role.

Parameters

Responses

__200__ * Description: An array of deleted permission's info. * Schema: [Permission](#permission) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Receipt Methods

GET /{orgId}/{appId}/receipts

Retrieve one or more receipts through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved receipt's info. * Schema: [Receipt](#receipt) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/{deviceId}/*/receipts

Retrieve receipts associated with one or more devices through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved receipt's info. * Schema: [Receipt](#receipt) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/{notificationId}/*/receipts

Retrieve receipts for one or more notifications through providing all the identifications."

Parameters

Responses

__200__ * Description: An array of retrieved receipt's info. * Schema: [Receipt](#receipt) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### Role Methods

GET /{orgId}/{appId}/roles

Retrieve the roles in an application through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved role's info. * Schema: [Role](#role) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/roles

Create a new role through providing all the identifications.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __roleproperty__ ([AddRole](#addrole)) The required properties of the role. (Specified in body).

Responses

__200__ * Description: An array of created role's info. * Schema: [Role](#role) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/roles/{rolename}

Remove a role through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of deleted role's info. * Schema: [Role](#role) __default__ * Description: Unexpected error. * Schema: [Error](#error) ### User Methods

GET /management/orgs/{orgId}/users

Retrieve details about the admin users in an organization.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path).

Responses

__200__ * Description: An array of retrieved Admin user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /management/orgs/{orgId}/users/{userId}

Remove an admin user from an organization through providing both Id of application and organization.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __userId-2__ (string) One of the user's identification which includes username, email address or UUID. (Specified in path).

Responses

__200__ * Description: An array of deleted Admin user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /management/users

Create a whole new admin user.

Parameters

* __adminuserproperty__ ([CreateAdminUser](#createadminuser)) One or more sets of user properties of which username is mandatory and must be unique. (Specified in body).

Responses

__200__ * Description: An array of new created Admin user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /management/users/{userId}

Retrieve details about an admin user.

Parameters

* __userId__ (string) One of the user's identification which includes username, real name, email address or UUID. (Specified in path).

Responses

__200__ * Description: An array of user's details * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

PUT /management/users/{userId}

Update the info of an admin user.

Parameters

* __userId__ (string) One of the user's identification which includes username, real name, email address or UUID. (Specified in path).

Responses

__200__ * Description: An array of user's details. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/groups/{groupId}/users/{userId}

Add a user to a group through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of added user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/groups/{groupId}/users/{userId}

Delete user from a group through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of deleted user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/roles/{roleId}/users

Retrieve the users in a role through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/roles/{roleId}/users/{userId}

Add a user to a role through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of added user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/roles/{roleId}/users/{userId}

Remove a user from a role through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of deleted user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/users

Retrieve users though query statement.

Parameters

Responses

__200__ * Description: An array of retrieved user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

POST /{orgId}/{appId}/users

Create a user in the users collection through providing all the identifications.

Parameters

* __orgId__ (string) One of the organization's identification which includes name or uuid. (Specified in path). * __appId__ (string) One of the application's identification which includes name or uuid. (Specified in path). * __CreateUser__ ([CreateUser](#createuser)) The properties of the user. (Specified in body).

Responses

__200__ * Description: An array of created user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

GET /{orgId}/{appId}/users/{userId}

Retrieve a user through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of retrieved user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

PUT /{orgId}/{appId}/users/{userId}

Update a user through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of updated user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error)

DELETE /{orgId}/{appId}/users/{userId}

Remove a user through providing all the identifications.

Parameters

Responses

__200__ * Description: An array of deleted user's info. * Schema: [User](#user) __default__ * Description: Unexpected error. * Schema: [Error](#error) ## Models Properties for Usergrid default entities. ### Action __Properties__

Name	Type	Description	Required
action	string	The requested action.	false
status	string	The status of the requested action.	false
token	string	The token required for getting an AdminUser.	false

### ActivityFeed __Properties__

Name	Type	Description	Required
entityproperty	ref		false
category	string	The category of the activity.	false
metadataproperty	ref		false
objectproperty	ref		false
title	string	The title of the activity.	false
verb	string	The verb of the activity.	false
completeMsg	ref		false

### Actor __Properties__

Name	Type	Description	Required
displayname	string	The display of the name of the actor.	false
objecttype	string	The type of the actor.	false
objectuuId	string	The UUID of the actor.	false
entitytype	string	The entitytype of the actor.	false

### AddPermission __Properties__

Name	Type	Description	Required
operation	string	A comma-delimited set of HTTP methods (GET, PUT, POST, DELETE) that are allowed for the specified resource path.	true
resource_path	string	The path to the resources to be accessed.	true

### AddRole __Properties__

Name	Type	Description	Required
title	string	The title of the role.	true
role name	string	The name of the role.	true

### AdminUserUpdate __Properties__

Name	Type	Description	Required
city	string		false
state	string		false

### AppData __Properties__

Name	Type	Description	Required
tester/sandbox	string	The UUID of tester/sandbox.	false
tester/app1	string	The UUID of tester/app1.	false
tester/app2	string	The UUID of tester/app2.	false
completeMsg	ref		false

### CancelMSG __Properties__

Name	Type	Description	Required
canceled	boolean		true

### Collections __Properties__

Name	Type	Required
activities	string	false
feed	string	false
roles	string	false
users	string	false

### CreateActivity __Properties__

Name	Type	Required
displayName	string	true
uuid	string	true
username	string	true
image	ref	false
verb	string	true
content	string	true

### CreateAdminUser __Properties__

Name	Type	Required
username	string	true
email	string	false
name	string	false
password	string	false

### CreateApp __Properties__

Name	Type	Description	Required
token	string	The OAuth2 access token.	true
name	string	The name of the application.	true

### CreateEntities __Properties__

Name	Type	Description	Required

### CreateEntity __Properties__

Name	Type	Description	Required
property	string	The property of the entity.	false
value	string	The relevant value of the property.	false

### CreateEvent __Properties__

Name	Type	Description	Required
timestamp	string		true

### CreateGroup __Properties__

Name	Type	Description	Required
title	string	The title of the group.	true
path	string	The path of the group.	true

### CreateNotification __Properties__

Name	Type	Description	Required
notifier	ref		true
message	string	The push notitfication message that will be delivered to the user.	true

### CreateNotifications __Properties__

Name	Type	Description	Required

### CreateOrg __Properties__

Name	Type	Required
organization	string	true
username	string	true
name	string	true
email	string	true
password	string	true

### CreateUser __Properties__

Name	Type	Description	Required
username	string		true

### Credential __Properties__

Name	Type	Description	Required
client_Id	string	The Id of the client.	false
client_secret	string	The secret of the client.	false
completeMsg	ref		false

### Device __Properties__

Name	Type	Description	Required
uuid	string	Unique entity Id.	false
type	string	Type of entity.	false
name	string	Notifier display name.	false
metadata	ref		false
completeMsg	ref		false

### Entity __Properties__

Name	Type	Description	Required
uuid	string	The UUID of the entity.	false
type	string	The type of the entity.	false
actorproperty	ref		false
metadata	ref		false
name	string	The name of the entity.	false
message	string		false

### Error __Properties__

Name	Type	Required
code	integer	false
message	string	false
fields	object	false

### Event __Properties__

Name	Type	Description	Required
applicationName	string	The application name of the event.	false
entity	ref		false
url	string	The url of the event.	false
applicationId	string	The application UUID of the event.	false
parameters	string	The parameters of the event.	false
organization	string	The title of the organization.	false
completeMsg	ref		false

### Group __Properties__

Name	Type	Description	Required
uuid	string	The UUID of the group.	false
type	string	The type of the group.	false
created	string	The created Id for the group.	false
modified	string	The modified Id for the group.	false
path	string	The path of the group.	false
metadata	ref		false
title	string	The title of the group.	false
completeMsg	ref		false

### ImageModel __Properties__

Name	Type	Required
url	string	false
wIdth	integer	false
email	string	false

### Metadata __Properties__

Name	Type	Description	Required
cursor	string	The cursor of the metadata.	false
path	string	The path of the metadata.	false
sets	ref		false
collections	ref		false

### Notification __Properties__

Name	Type	Description	Required
uuid	string	Unique entity Id.	false
type	string	Type of entity.	false
payloads	string	The push notifications to be delivered.	true
errorMessage	string	Error message returned by the notification service (APNs or GCM) if the notification fails entirely.	false
scheduled	boolean	whether the notification is currently scheduled for delivery.	false
state	string	The current delivery status of the notification 'FINISHED', 'SCHEDULED' or 'CANCELED'.	false
metadata	ref		false
completeMsg	ref		false

### Notifier __Properties__

Name	Type	Description	Required
uuid	string	Unique entity Id.	false
type	string	Type of entity.	false
name	string	Notifier display name.	false
provider	string	Push notification provider 'apple' or 'google'.	true
environment	string	The environment that corresponds to your app 'development' or 'production'.	true
metadata	ref		false

### Object __Properties__

Name	Type	Description	Required
displayname	string	The display of the name of the object.	false
objecttype	string	The type of the object.	false
objectuuId	string	The UUID of the object.	false
entitytype	string	The entitytype of the object.	false

### Organization __Properties__

Name	Type	Description	Required
applicationId	string	The application Id of the owner.	false
username	string	The username of the owner.	false
name	string	The name of the owner.	false
email	string	The email of the owner.	false
activated	boolean	Indicate whether the account is activated or not.	false
disabled	boolean	Indicate whether the account is disabled or not.	false
uuid	string	The UUID of the owner.	false
adminUser	boolean	Indicate whether the use is a adminUser or not.	false
displayEmail	string	The display of the email of the owner.	false
htmldisplayEmail	string	The HTML display of the email of the owner.	false
orgname	string	The name of the organization.	false
orguuId	string	The UUID of the organization.	false
applicationdata	ref		false
completeMsg	ref		false

### Permission __Properties__

Name	Type	Description	Required
applicationName	string	The name of the application of the permission.	false
entity	ref		false
url	string	The url of the permission.	false
applicationId	string	The UUID of the application.	false
parameters	string	The parameters of the permission.	false
organization	string	The organization of the permission.	false
permissiondata	ref		false

### Receipt __Properties__

Name	Type	Description	Required
uuid	string	Unique entity Id.	false
type	string	Type of entity.	false
payloads	string	The push notifications to be delivered.	false
errorMessage	string	Error message returned by the notification service (APNs or GCM) if the notification fails entirely.	false
errorCode	string	Error code returned by the notification service.	false
sent	number	UTC timestamp in milliseconds for when the notification was sent.	false
metadata	ref		false
completeMsg	ref		false

### ResetPW __Properties__

Name	Type	Description	Required
password	string		true
newpassword	string		true

### ResetPWMsg __Properties__

Name	Type	Description	Required
recaptcha_response	string	Parameters and value for the Captcha challenge.	true
recaptcha_challenge	string	The admin user's response to the Captcha challenge.	true
email	string		true

### Role __Properties__

Name	Type	Description	Required
applicationName	string	The application name of the event.	false
entity	ref		false
url	string	The url of the event.	false
applicationId	string	The application UUID of the event.	false
parameters	string	The parameters of the event.	false
organization	string	The title of the organization.	false
completeMsg	ref		false
path	string	The path of the role.	false

### ScheduleNotification __Properties__

Name	Type	Description	Required
timestamp	string	UTC timestamp in milliseconds of when schedule notifications.	true

### SetExpiration __Properties__

Name	Type	Description	Required
timestamp	string	UTC timestamp in milliseconds of when set expirations.	true

### Sets __Properties__

Name	Type	Description	Required
rolenames	string		false
permissions	string		false

### User __Properties__

Name	Type	Description	Required
applicationId	string	The application Id of a user.	false
username	string	The username of a user.	false
name	string	The name of a user.	false
email	string	The email of a user.	false
activated	boolean	Indicate whether the account is activated or not.	false
disabled	boolean	Indicate whether the account is disabled or not.	false
uuid	string	The UUID of a user.	false
adminUser	boolean	Indicate whether the use is a adminUser or not.	false
displayEmail	string	The display of the email of a user.	false
htmldisplayEmail	string	The HTML display of the email of a user.	false
organization	string	The organization of the user.	false
picture	string	The uri of the user's picture.	false
uri	string	The uri of the user.	false
path	string	The path of the user.	false
completeMsg	ref		false