Integrate the KeepSafe Intelligence SDK into your own app.

The KeepSafe Intelligence SDK gives integrators a machine-to-machine path into monitored assets and event feeds. Authenticate with OAuth2 client credentials, fetch a user feed, and build your own event views, maps, and alert workflows.

Open Swagger docs Reference implementation Demo site

Auth model

OAuth2 client credentials via Cognito

Primary feed endpoint

GET /v1/feed/{userid}

Asset endpoints

Create, list, retrieve, update, and delete monitored assets

Quickstart

Request an access token using the OAuth2 client_credentials grant.
Include the Bearer token in requests to the KeepSafe Access API.
Call GET /v1/feed/{userid} to retrieve a user event feed.
Optionally manage monitored assets through the /v1/assets endpoints.

POST https://<cognito-domain>/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=<your-client-id>
&client_secret=<your-client-secret>
&scope=keepsafe-access/feed

Feed endpoint

GET/v1/feed/{userid}

Returns the event feed for the specified user. The response is based on JSON Feed items with KeepSafe-specific metadata under _keepsafe.

Asset collection

GET/v1/assets

POST/v1/assets

List monitored assets for the authenticated user or create a new one with coordinates, radius, and optional description/query fields.

Individual asset

GET/v1/assets/{id}

PUT/v1/assets/{id}

DELETE/v1/assets/{id}

Retrieve, update, or delete a specific asset. Ownership is enforced, so users can only modify assets associated with their token identity.