Skip to content

Cognitive Systems WiFi Motion AppCloud API (v1-5-x)

The AppCloud APIs are used by mobile applications to communicate with the Cognitive Systems Infrastructure.

Download OpenAPI description
v1-5-x.json
v1-5-x.yaml
Languages
Servers
Mock server

https://docs.cognitivesystems.com/_mock/assets/specs/app-cloud/v1-5-x/

https://docs.cognitivesystems.com/api/v1/

Overview

Operations

Out of Box

Operations

Logging In

Operations

Login using AWS Cognito and Begin Session

Request

This API endpoint allows users to create a session by authenticating via AWS Cognito's Single Sign-On (SSO).

The endpoint validates an Cognito JWT token and then follows the /sessions flow to establish a user session

Bodyapplication/json
access_tokenstringrequired

JWT token issued by AWS Cognito

Example: "NEW.COGNITO.AUTH.TOKEN"
curl -i -X POST \
  https://docs.cognitivesystems.com/_mock/assets/specs/app-cloud/v1-5-x/sessions/sso/cognito \
  -H 'Content-Type: application/json' \
  -d '{
    "access_token": "NEW.COGNITO.AUTH.TOKEN"
  }'

Responses

200 OK

Bodyapplication/json
refresh_tokenstring
tokenstring
userobject
Response
application/json
{
  "refresh_token": "JWT TOKEN",
  "token": "JWT TOKEN",
  "user": {
    "id": 601,
    "email": "user@cognitivesystems.com",
    "first_name": "John",
    "last_name": "Smith",
    "created_at": "2020-01-04T22:05:38.793Z",
    "updated_at": "2020-01-04T22:06:02.059Z",
    "confirmed_at": "2020-01-04T22:06:02.056Z"
  }
}

Show Users

Request

Get basic user information

Security
Authorization
Path
idinteger>= 1required
curl -i -X GET \
  'https://docs.cognitivesystems.com/_mock/assets/specs/app-cloud/v1-5-x/users/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
idinteger
Example: 98
usernamestring
emailstring
Example: "test@cognitivesystems.com"
first_namestring
Example: "Cognitive"
last_namestring
Example: "Systems"
created_atstring
Example: "2021-04-12T21:04:19.647Z"
updated_atstring
Example: "2021-04-12T21:04:38.403Z"
confirmed_atstring or null
Example: "2021-04-12T21:04:38.403Z"
Response
application/json
{
  "id": 98,
  "username": "",
  "email": "test@cognitivesystems.com",
  "first_name": "Cognitive",
  "last_name": "Systems",
  "created_at": "2021-04-12T21:04:19.647Z",
  "updated_at": "2021-04-12T21:04:38.403Z",
  "confirmed_at": "2021-04-12T21:04:38.403Z"
}

Reset Account Password

Request

Update user password. Endpoint used by the 'Enter new password page' in the reset password flow.

Bodyapplication/json
tokenstringrequired
passwordstring
curl -i -X PUT \
  https://docs.cognitivesystems.com/_mock/assets/specs/app-cloud/v1-5-x/password_resets \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "string",
    "password": "string"
  }'

Responses

Bodyapplication/json
idinteger
emailstring
first_namestring
last_namestring
usernamestring
confirmed_atstring or null
created_atstring
updated_atstring
Response
application/json
{
  "id": 0,
  "email": "string",
  "first_name": "string",
  "last_name": "string",
  "username": "string",
  "confirmed_at": "string",
  "created_at": "string",
  "updated_at": "string"
}

Geofencing

Operations

Account Management

Operations

Network Settings

Operations

Sounding v2

Operations

Events, History, and Visualizations

Operations

Household Insights [BETA]

Operations

Zone Priority [BETA]

Operations

Universal Alerting

Operations

Meta

Operations

Administration

Operations