# Out of Box

## Store Device Push Token

 - [POST /mobile_devices](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_mobile_devices.md): Store instance token to facilitate the usage of firebase services between App Cloud and Wifi Motion App.

The instance token provides a unique identifier for each app instance and a mechanism to authenticate and authorize actions (example: sending FCM messages)

If the token sent is set to 'eee-motioncsc-loadtest' the push notification payload will be formed but NOT sent to firebase. This is used in load testing to ensure APPCLD is not blacklisted by Google.

## Delete Members

 - [DELETE /network_memberships/{id}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/delete_network_memberships-id.md)

## Show Network Members

 - [GET /network_memberships](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/get_network_memberships.md)

## Create Network Members

 - [POST /network_memberships](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_network_memberships.md)

## Resend Confirmation Email

 - [POST /confirmation_mails](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_confirmation_mails.md): Endpoint to send another confirmation email when user presses 'RESEND EMAIL' button during account creation.

## Confirm New Account

 - [GET /confirmations](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/get_confirmations.md): After the user receives a confirmation email. This link should open the app, and pass the included token to this User Confirmation GET request.

A successful response means that the account associated with the token/email is now confirmed, and can be used for OOB or view network as a member.

Note: This is NOT the same token as was returned by the #endpoint:u8SLn5ebDpLA96m7B endpoint. They are both jwt tokens with the same format but they have different token audience, expiry and payload data.

## Send Account Confirmation Email

 - [POST /confirmations](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_confirmations.md): Endpoint to send confirmation email during account creation.

## Create User

 - [POST /users](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_users.md): Creates an unconfirmed user that is not associated with any motion network

## Network Search/Create

 - [POST /searches](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_searches.md): Get or create a Wi-Fi Motion network in App Cloud. The BSSID is shared with Core when the network first comes online.

This endpoint verifies the existence of the user's network in Core and if it's claimable. If the network is present in Core, but not in App Cloud, the network is created.

Calling this endpoint has one of the following outcomes:

-   Network not found in MNS Core (404)
-   Network found, already in App Cloud and returned (200)
-   Network found, not in App Cloud, created, and returned (200)

In the response object,  tells you whether the network has an owner.  

If  is false, the network can be claimed by calling /api/v1/network_memberships. If  is true, the user can only be added as a member.

## Network Find/Create

 - [POST /find](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/post_find.md): Get or create a Wi-Fi Motion network in App Cloud. The Guardian Id is shared with Core when the network first comes online.

This endpoint verifies the existence of the user's network in Core and if it's claimable. If the network is present in Core, but not in App Cloud, the network is created.

Calling this endpoint has one of the following outcomes:

-   Network not found in MNS Core (404)
-   Network found, already in App Cloud and returned (200)
-   Network found, not in App Cloud, created, and returned (200)

In the response object,  tells you whether the network has an owner.  

If  is false, the network can be claimed by calling /api/v1/network_memberships. If  is true, the user can only be added as a member.

## Delete Device Push Token

 - [DELETE /mobile_devices/{id}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/out-of-box/delete_moble_devices.md): Deletes the firebase token associated with an app. Acts as a log off mechanism to allow a user to deregister a mobile device.