Skip to main content

STS APIs (1.0)

Download OpenAPI specification:Download

MEGH Computing

Socket Transition Service

API documentation.

ACL

ACL list

Lists all the UI modules for all the roles by default.

Sample OUTPUT

{
  "message": "string",
  "response": [
    {
      "components": [
        {
          "component_key": 0,
          "component_name": "string"
        }
      ],
      "module_key": "string",
      "module_name": "string",
      "module_path": "string"
    }
  ],
  "response_code": 0
}

To get list of UI modules for a specific role, role_key is accepted and query params.

Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

Upload Excel/CSV

Takes in a file and stores the file.

Upload a file with form pram modulefile

Sample CSV file content

type,key,name,role,/channel/list,module_key
mod,dashboard,Dashboard,admin|user|viewer,/dashboard,
comp,28,DashboardCard,admin|user|viewer,,dashboard
mod,dashboard-old,Dashboard,admin|user|viewer,/dashboard-old,
comp,29,UseCaseCard,admin|user|viewer,,dashboard-old
Authorizations:
OAuth2Password
query Parameters
modulefile
required
string
Default: "test.csv"

csv module file

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Alert

Alert Active

Alert Active API.

Sample INPUT

{
  "channel_id": "string"
}

Sample OUTPUT

{
  "message": "Active alert",
  "response": [
    {
      "alert_actions": [
        {
          "action_access_id": "string",
          "action_access_token": "string",
          "action_auth_header": "string",
          "action_external_link": "string",
          "action_header": "string",
          "action_is_auto_payload": true,
          "action_is_secure": true,
          "action_message": "string",
          "action_method": "string",
          "action_payload": "string",
          "action_process_delay": 0,
          "action_query": "string",
          "action_subject": "string",
          "action_to": "string",
          "action_type": "string",
          "action_url": "string"
        }
      ],
      "alert_frequency": 0,
      "alert_id": "string",
      "alert_name": "string",
      "alert_priority": "string",
      "alert_threshold": "string",
      "alert_threshold_condition": "string",
      "alert_threshold_key": "string",
      "is_active": true
    }
  ],
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert ID Payload

channel_id
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

Alert Create

Alert Create API.

Sample INPUT

{
  "alert_actions": [
    {
      "action_access_id": "string",
      "action_access_token": "string",
      "action_auth_header": "string",
      "action_external_link": "string",
      "action_header": "string",
      "action_is_auto_payload": true,
      "action_is_secure": true,
      "action_message": "string",
      "action_method": "string",
      "action_payload": "string",
      "action_process_delay": 0,
      "action_query": "string",
      "action_subject": "string",
      "action_to": "string",
      "action_type": "string",
      "action_url": "string",
      "additionalProp1": {}
    }
  ],
  "alert_frequency": 0,
  "alert_name": "string",
  "alert_priority": "string",
  "alert_threshold": "string",
  "alert_threshold_condition": "string",
  "alert_threshold_key": "string",
  "channel_id": "string"
}

Sample OUTPUT

{
  "message": "Alert created",
  "response": null,
  "response_code": 201
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert Create Payload

required
Array of objects
alert_frequency
required
integer [ 0 .. 86400 ]
alert_name
required
string
alert_priority
required
string
alert_threshold
required
string
alert_threshold_condition
required
string
alert_threshold_key
required
string
channel_id
required
string

Responses

Request samples

Content type
application/json
{
  • "alert_actions": [
    ],
  • "alert_frequency": 86400,
  • "alert_name": "string",
  • "alert_priority": "string",
  • "alert_threshold": "string",
  • "alert_threshold_condition": "string",
  • "alert_threshold_key": "string",
  • "channel_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Alert Delete

Alert Delete API

Sample INPUT

{
  "alert_id": "string"
}

Sample OUTPUT

{
  "message": "Alert deleted",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert Delete Payload

alert_id
required
string

Responses

Request samples

Content type
application/json
{
  • "alert_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Alert Disable

Alert De-Activate API.

Sample INPUT

{
  "alert_id": "string"
}

Sample OUTPUT

{
  "message": "Alert deactivated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert Disable Payload

alert_id
required
string
channel_id
required
string

Responses

Request samples

Content type
application/json
{
  • "alert_id": "string",
  • "channel_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Alert Enable

Alert Activate API.

Sample INPUT

{
  "alert_id": "string"
}

Sample OUTPUT

{
  "message": "Alert activated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert Enable Payload

alert_id
required
string
channel_id
required
string

Responses

Request samples

Content type
application/json
{
  • "alert_id": "string",
  • "channel_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Alert ID

Alert ID API.

Sample INPUT

{
  "alert_id": "string"
}

Sample OUTPUT

{
  "message": "Alert by ID",
  "response": {
    "alert_actions": [
      {
        "action_access_id": "string",
        "action_access_token": "string",
        "action_auth_header": "string",
        "action_external_link": "string",
        "action_header": "string",
        "action_is_auto_payload": true,
        "action_is_secure": true,
        "action_message": "string",
        "action_method": "string",
        "action_payload": "string",
        "action_process_delay": 0,
        "action_query": "string",
        "action_subject": "string",
        "action_to": "string",
        "action_type": "string",
        "action_url": "string"
      }
    ],
    "alert_frequency": 0,
    "alert_id": "string",
    "alert_name": "string",
    "alert_priority": "string",
    "alert_threshold": "string",
    "alert_threshold_condition": "string",
    "alert_threshold_key": "string",
    "is_active": true
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert ID Payload

alert_id
required
string

Responses

Request samples

Content type
application/json
{
  • "alert_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Alert List by Channel ID

Alert List API.

Sample INPUT

{
  "channel_id": "string"
}

Sample OUTPUT

{
  "message": "Alert list",
  "response": [
    {
      "alert_actions": [
        {
          "action_access_id": "string",
          "action_access_token": "string",
          "action_auth_header": "string",
          "action_external_link": "string",
          "action_header": "string",
          "action_is_auto_payload": true,
          "action_is_secure": true,
          "action_message": "string",
          "action_method": "string",
          "action_payload": "string",
          "action_process_delay": 0,
          "action_query": "string",
          "action_subject": "string",
          "action_to": "string",
          "action_type": "string",
          "action_url": "string"
        }
      ],
      "alert_frequency": 0,
      "alert_id": "string",
      "alert_name": "string",
      "alert_priority": "string",
      "alert_threshold": "string",
      "alert_threshold_condition": "string",
      "alert_threshold_key": "string",
      "is_active": true
    }
  ],
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert List Payload

channel_id
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

Notification Gallery

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "channel_id": "string",
  "notification_uuid": "string"
}

Sample Output

{
  "message": "Notifications gallery by UUID",
  "response": {
    "channel_id": "string",
    "gallery": [
      {
        "image": [
          0
        ],
        "time_stamp": "string",
        "uuid": "string"
      }
    ],
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
usecase_key
required
string

Usecase Key

channel_id
required
string

Channel ID

notification_offset
integer

Notification Offset

notification_limit
integer

Notification Limit

start
required
string

Start Time

end
required
string

End Time

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Notification Gallery Image by ID

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "channel_id": "string",
  "notification_uuid": "string"
}

Sample Output

{
  "message": "Notifications gallery by UUID",
  "response": {
    "channel_id": "string",
    "gallery": [
      {
        "image": [
          0
        ],
        "time_stamp": "string",
        "uuid": "string"
      }
    ],
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
channel_id
required
string

Channel ID

notification_uuid
integer

Notification UUID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Notifications By Range

Notification By Range API.

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "channel_id": "string",
  "notification_offset": 0,
  "notification_limit": 0,
  "start": "string",
  "end": "string"
}

Sample OUTPUT

Hello

{
  "message": "Notifications by range",
  "response": {
    "channel_id": "string",
    "end": "string",
    "notifications": [
      {
        "channel_id": "string",
        "notification_data": {
          "attachment": "string",
          "from": "string",
          "message": "string",
          "subject": "string",
          "to": "string"
        },
        "notification_extra": "string",
        "notification_time": "string",
        "notification_uuid": "string",
        "usecase_key": "string"
      }
    ],
    "start": "string",
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
usecase_key
required
string

UseCase Key

channel_ids
required
string

Channel ID

notification_offset
integer

Notification Offset

notification_limit
integer

Notification Limit

start
required
string

Start Time

end
required
string

End Time

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Notification By UUID

Notification By UUID API.

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "channel_id": "string",
  "notification_uuid": "string"
}

Sample OUTPUT

Hello

{
  "message": "Notification by UUID",
  "response": {
    "channel_id": "string",
    "notification_data": {
      "attachment": "string",
      "from": "string",
      "message": "string",
      "subject": "string",
      "to": "string"
    },
    "notification_extra": "string",
    "notification_time": "string",
    "notification_uuid": "string",
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
usecase_key
required
string

UseCase Key

channel_id
required
string

Channel ID

notification_uuid
required
string

Notification UUID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Alert Update

Alert Update API.

Sample INPUT

{
  "alert_actions": [
    {
      "action_access_id": "string",
      "action_access_token": "string",
      "action_auth_header": "string",
      "action_external_link": "string",
      "action_header": "string",
      "action_is_auto_payload": true,
      "action_is_secure": true,
      "action_message": "string",
      "action_method": "string",
      "action_payload": "string",
      "action_process_delay": 0,
      "action_query": "string",
      "action_subject": "string",
      "action_to": "string",
      "action_type": "string",
      "action_url": "string"
    }
  ],
  "alert_frequency": 0,
  "alert_id": "string",
  "alert_name": "string",
  "alert_priority": "string",
  "alert_threshold": "string",
  "alert_threshold_condition": "string",
  "alert_threshold_key": "string",
  "is_active": true
}

Sample OUTPUT

{
  "message": "Alert updated",
  "response": {
    "alert_actions": [
      {
        "action_access_id": "string",
        "action_access_token": "string",
        "action_auth_header": "string",
        "action_external_link": "string",
        "action_header": "string",
        "action_is_auto_payload": true,
        "action_is_secure": true,
        "action_message": "string",
        "action_method": "string",
        "action_payload": "string",
        "action_process_delay": 0,
        "action_query": "string",
        "action_subject": "string",
        "action_to": "string",
        "action_type": "string",
        "action_url": "string"
      }
    ],
    "alert_frequency": 0,
    "alert_id": "string",
    "alert_name": "string",
    "alert_priority": "string",
    "alert_threshold": "string",
    "alert_threshold_condition": "string",
    "alert_threshold_key": "string",
    "is_active": true
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Alert Update Payload

required
Array of objects
alert_frequency
required
integer [ 0 .. 86400 ]
alert_id
required
string
alert_name
required
string
alert_priority
required
string
alert_threshold
required
string
alert_threshold_condition
required
string
alert_threshold_key
required
string
channel_id
required
string

Responses

Request samples

Content type
application/json
{
  • "alert_actions": [
    ],
  • "alert_frequency": 86400,
  • "alert_id": "string",
  • "alert_name": "string",
  • "alert_priority": "string",
  • "alert_threshold": "string",
  • "alert_threshold_condition": "string",
  • "alert_threshold_key": "string",
  • "channel_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Analytics

Events By Range

Event By Range API.

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "usecase_meta_key": [
    "string"
  ],
  "channel_id": "string",
  "event_offset": 0,
  "event_limit": "string",
  "start": "string",
  "end": "string",
  "agg_frequency": "string",
  "details": false,
  "type": 0
}

Sample OUTPUT

{
  "message": "Alert activated",
  "response": {
    "agg_frequency": "string",
    "channel_id": "string",
    "end": "string",
    "event_limit": 0,
    "event_offset": 0,
    "events": [
      {
        "alert": 0,
        "down": 0,
        "dwell_time": 0,
        "fire": 0,
        "frame_collision": 0,
        "frame_near_miss": 0,
        "high_smoke": 0,
        "id": 0,
        "ids": [
          "string"
        ],
        "intermediate_smoke": 0,
        "low_smoke": 0,
        "metadata": "string",
        "moving_average_count": 0,
        "non_violation": 0,
        "occupancy": 0,
        "threshold": "string",
        "time": "string",
        "total": 0,
        "total_collision": 0,
        "total_near_miss": 0,
        "up": 0,
        "violation": 0
      }
    ],
    "start": "string",
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
usecase_key
required
string

UseCase Key

usecase_meta_key
required
string

UseCase Meta Key

channel_id
required
string

Channel ID

event_offset
integer

Event Offset

event_limit
integer

Event Limit

start
required
string

Start Time

end
required
string

End Time

agg_frequency
required
string
Default: "60s"

Aggregation Frequency

details
required
boolean
Default: false

details

type
required
integer
Default: 1

type

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Channel Stats

Event Alert Stats API.

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "usecase_meta_key": [
    "string"
  ],
  "channel_id": "string",
  "frequency": "-string"
}

Sample OUTPUT

{
  "message": "Alert activated",
  "response": {
    "channel_alert": {
      "channel": "string",
      "condition": "string",
      "count": 0,
      "key": "string",
      "name": "string",
      "time": "string"
    },
    "channel_id": "string",
    "channel_key": "string",
    "channel_name": "string",
    "channel_stats": {
      "alert": 0,
      "down": 0,
      "dwell_time": 0,
      "fire": 0,
      "frame_collision": 0,
      "frame_near_miss": 0,
      "high_smoke": 0,
      "ids": [
        "string"
      ],
      "intermediate_smoke": 0,
      "low_smoke": 0,
      "moving_average_count": 0,
      "non_violation": 0,
      "occupancy": 0,
      "total": 0,
      "total_collision": 0,
      "total_near_miss": 0,
      "up": 0,
      "violation": 0
    },
    "channel_total_alert": 0,
    "channel_total_notification": 0,
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
usecase_key
required
string

UseCase Key

usecase_meta_key
required
string

UseCase Meta Key

channel_id
required
string

Channel ID

frequency
required
string
Default: "-1h"

Frequency

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

UseCase Stats

Notification Stats By Usecase API.

Sample INPUT

// Query params

{
  "usecase_key": "string",
  "usecase_meta_key": [
    "string",
    "string",
    "string"
  ],
  "channel_id": "string",
  "frequency": "string",
  "details": true
}

Sample OUTPUT

Hello

{
  "message": "Notification stats",
  "response": {
    "usecase_channel": [
      {
        "channel_alert": {
          "channel": "string",
          "condition": "string",
          "count": 0,
          "key": "string",
          "name": "string",
          "time": "string"
        },
        "channel_id": "string",
        "channel_key": "string",
        "channel_name": "string",
        "channel_stats": {
          "alert": 0,
          "down": 0,
          "dwell_time": 0,
          "fire": 0,
          "frame_collision": 0,
          "frame_near_miss": 0,
          "high_smoke": 0,
          "ids": [
            "string"
          ],
          "intermediate_smoke": 0,
          "low_smoke": 0,
          "moving_average_count": 0,
          "non_violation": 0,
          "occupancy": 0,
          "total": 0,
          "total_collision": 0,
          "total_near_miss": 0,
          "up": 0,
          "violation": 0
        },
        "channel_total_alert": 0,
        "channel_total_notification": 0,
        "usecase_key": "string"
      }
    ],
    "usecase_key": "string",
    "usecase_total_alert": 0,
    "usecase_total_notification": 0,
    "usecase_total_stats": {
      "down": 0,
      "dwelltime": 0,
      "fire": 0,
      "framecollision": 0,
      "framenearmiss": 0,
      "highsmoke": 0,
      "intermediatesmoke": 0,
      "lowsmoke": 0,
      "movingaveragecount": 0,
      "nonviolation": 0,
      "occupancy": 0,
      "total": 0,
      "totalcollision": 0,
      "totalnearmiss": 0,
      "up": 0,
      "violation": 0
    }
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
usecase_key
required
string

UseCase Key

usecase_meta_key
required
string

UseCase Meta Key

frequency
required
string
Default: "-1h"

Frequency

details
required
boolean
Default: false

details

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

UseCase Stats

Usecase Stats API

Sample INPUT

{
  "details": true,
  "frequency": "string",
  "usecase_key": "string",
  "usecase_meta_key": [
    "string"
  ]
}

Sample OUTPUT

 {
  "message": "Usecase deleted",
  "response":  {
    "usecase_channel": [
      {
        "channel_alert": {
          "channel": "string",
          "condition": "string",
          "count": 0,
          "key": "string",
          "name": "string",
          "time": "string"
        },
        "channel_id": "string",
        "channel_key": "string",
        "channel_name": "string",
        "channel_stats": {
          "alert": 0,
          "down": 0,
          "dwell_time": 0,
          "fire": 0,
          "frame_collision": 0,
          "frame_near_miss": 0,
          "high_smoke": 0,
          "ids": [
            "string"
          ],
          "intermediate_smoke": 0,
          "low_smoke": 0,
          "moving_average_count": 0,
          "non_violation": 0,
          "occupancy": 0,
          "total": 0,
          "total_collision": 0,
          "total_near_miss": 0,
          "up": 0,
          "violation": 0
        },
        "channel_total_alert": 0,
        "channel_total_notification": 0,
        "usecase_key": "string"
      }
    ],
    "usecase_key": "string",
    "usecase_total_alert": 0,
    "usecase_total_notification": 0,
    "usecase_total_stats": {
      "alert": 0,
      "down": 0,
      "dwell_time": 0,
      "fire": 0,
      "frame_collision": 0,
      "frame_near_miss": 0,
      "high_smoke": 0,
      "ids": [
        "string"
      ],
      "intermediate_smoke": 0,
      "low_smoke": 0,
      "moving_average_count": 0,
      "non_violation": 0,
      "occupancy": 0,
      "total": 0,
      "total_collision": 0,
      "total_near_miss": 0,
      "up": 0,
      "violation": 0
    }
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

UseCase Stats Payload

details
required
boolean
frequency
required
string
usecase_key
required
string
usecase_meta_key
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "details": true,
  • "frequency": "string",
  • "usecase_key": "string",
  • "usecase_meta_key": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

UseCase Report

Usecase Report API

Sample INPUT

{
  "details": true,
  "frequency": "string",
  "usecase_key": "string",
  "usecase_meta_key": [
    "string"
  ]
}

Sample OUTPUT

 {
  "message": "Usecase deleted",
  "response": {
    "channel_stats": {
      "alert": 0,
      "down": 0,
      "dwell_time": 0,
      "fire": 0,
      "frame_collision": 0,
      "frame_near_miss": 0,
      "high_smoke": 0,
      "ids": [
        "string"
      ],
      "intermediate_smoke": 0,
      "low_smoke": 0,
      "moving_average_count": 0,
      "non_violation": 0,
      "occupancy": 0,
      "total": 0,
      "total_collision": 0,
      "total_near_miss": 0,
      "up": 0,
      "violation": 0
    }
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

UseCase Stats Payload

channel_id
required
string
details
required
boolean
end_date
required
string
start_date
required
string
usecase_key
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string",
  • "details": true,
  • "end_date": "string",
  • "start_date": "string",
  • "usecase_key": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

User

User Auth

User Auth with return Access token

query Parameters
is_secret
boolean

Reveal Secret

client_id
string

Reveal Secret for Client ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

User Auth

User Auth with return Access token

Request Body schema: application/json

User Auth Payload

email
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "string",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

User Config By ID

User Config Update By ID

Sample INPUT

{
  "user_config": {
    "channel_ids": [
      "string"
    ],
    "role_id": "string",
    "ui_config": {
      "additionalProp1": {}
    },
    "usecase_ids": [
      "string"
    ],
    "user_id": "string"
  },
  "user_id": "string"
}

Sample OUTPUT

{
  "message": "User Config Updated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

User Config By ID Payload

user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

User Config Update By ID

User Config Update By ID

Sample INPUT

{
  "user_config": {
    "channel_ids": [
      "string"
    ],
    "role_id": "string",
    "ui_config": {
      "additionalProp1": {}
    },
    "usecase_ids": [
      "string"
    ],
    "user_id": "string"
  },
  "user_id": "string"
}

Sample OUTPUT

{
  "message": "User Config Updated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

User Config Update By ID Payload

object (user.userConfigResp)
user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "user_config": {
    },
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

User Register

New User Register

Sample INPUT

{
  "email": "string",
  "first_name": "string",
  "last_name": "string",
  "password": "string",
  "role_key": "string"
}

Sample OUTPUT

{
  "message": "User Registered",
  "response": {
    "avatar": "string",
    "channel_ids": [
      "string"
    ],
    "email": "string",
    "first_name": "string",
    "is_active": true,
    "is_verified": true,
    "last_logged_in_at": "string",
    "last_name": "string",
    "role_id": "string",
    "role_key": "string",
    "ui_config": {
      "additionalProp1": {}
    },
    "usecase_ids": [
      "string"
    ],
    "user_id": "string",
    "user_name": "string"
  },
  "response_code": 201
}
Request Body schema: application/json

User Register Payload

email
required
string
first_name
required
string
last_name
required
string
password
required
string
role_key
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "string",
  • "first_name": "string",
  • "last_name": "string",
  • "password": "string",
  • "role_key": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

User Delete

User Delete by ID

Sample INPUT

{
  "user_id": "string"
}

Sample OUTPUT

{
  "message": "User Deleted",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

User Update Payload

user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

User Get By ID

User Get by ID

Sample INPUT

{
  "user_id": "string"
}

Sample OUTPUT

{
  "message": "User By ID",
  "response": {
    "avatar": "string",
    "channel_ids": [
      "string"
    ],
    "email": "string",
    "first_name": "string",
    "is_active": true,
    "is_verified": true,
    "last_logged_in_at": "string",
    "last_name": "string",
    "role_id": "string",
    "role_key": "string",
    "ui_config": {
      "additionalProp1": {}
    },
    "usecase_ids": [
      "string"
    ],
    "user_id": "string",
    "user_name": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

User Get By ID Payload

user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

User Info

User Info by Access token

Sample OUTPUT

{
  "message": "User By ID",
  "response": {
    "avatar": "string",
    "channel_ids": [
      "string"
    ],
    "email": "string",
    "first_name": "string",
    "is_active": true,
    "is_verified": true,
    "last_logged_in_at": "string",
    "last_name": "string",
    "role_id": "string",
    "role_key": "string",
    "ui_config": {
      "additionalProp1": {}
    },
    "usecase_ids": [
      "string"
    ],
    "user_id": "string",
    "user_name": "string",
    "user_config": {
      "channel_ids": [
        "string"
      ],
      "role_id": "string",
      "ui_config": {
        "additionalProp1": {}
      },
      "usecase_ids": [
        "string"
      ],
      "user_id": "string"
    }
  },
  "response_code": 200
}
Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

User List

User List`

Sample OUTPUT

{
  "message": "User List",
  "response": [
    {
      "avatar": "string",
      "channel_ids": [
        "string"
      ],
      "email": "string",
      "first_name": "string",
      "is_active": true,
      "is_verified": true,
      "last_logged_in_at": "string",
      "last_name": "string",
      "role_id": "string",
      "role_key": "string",
      "ui_config": {
        "additionalProp1": {}
      },
      "usecase_ids": [
        "string"
      ],
      "user_id": "string",
      "user_name": "string"
    }
  ],
  "response_code": 200
}
Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

User Update

User Update by ID

Sample INPUT

{
  "change_password": true,
  "confirm_password": "string",
  "email": "string",
  "first_name": "string",
  "last_name": "string",
  "password": "string",
  "role_id": "string",
  "user_id": "string"
}

Sample OUTPUT

{
  "message": "User Updated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

User Update Payload

change_password
required
boolean
confirm_password
string
email
required
string
first_name
string
last_name
string
password
string
role_id
required
string
user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "change_password": true,
  • "confirm_password": "string",
  • "email": "string",
  • "first_name": "string",
  • "last_name": "string",
  • "password": "string",
  • "role_id": "string",
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Auto

Auto Test

Auto Test API.

Sample OUTPUT

{
    "message": "Auto Test",
    "response": null,
    "response_code": 200
}

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Bundle

Bundle List

Bundle List API.

Sample OUTPUT

{
  "message": "Bundle List",
  "response": [
    {
      "bundle_id": "string",
      "bundle_key": "string",
      "bundle_name": "string",
      "bundle_usecases": {
        "usecase_background_color": "string",
        "usecase_channel_count": 0,
        "usecase_component_key": "string",
        "usecase_desc": "string",
        "usecase_icon": "string",
        "usecase_id": "string",
        "usecase_key": "string",
        "usecase_meta_key": [
          {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          }
        ],
        "usecase_name": "string"
      }
    }
  ],
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
customer_id
required
string

Customer ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

Channel

Channel Assign

Channel Assign API

Sample INPUT

{
  "channel_id": [
    "string"
  ],
  "user_id": "string"
}

Sample OUTPUT

 {
  "message": "Channel assigned",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Assign Payload

channel_id
required
Array of strings
user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": [
    ],
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel Create

Channel Create API

Sample INPUT

{
  "channel_name": "string",
  "channel_sid": "string",
  "channel_threshold": "string",
  "channel_threshold_duration": 0,
  "usecase_key": "string"
}

Sample OUTPUT

 {
  "message": "Channel Created",
  "response": {
    "channel_id": "string",
    "transactions_id": "string"
  },
  "response_code": 201
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Create Payload

channel_name
required
string
nimble_id
required
string
pipeline_id
required
string
site_id
required
string
source_id
required
string
usecase_key
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_name": "string",
  • "nimble_id": "string",
  • "pipeline_id": "string",
  • "site_id": "string",
  • "source_id": "string",
  • "usecase_key": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel Delete

Channel Delete API

Sample INPUT

{
  "channel_id": "string",
  "is_force": false
}

Sample OUTPUT

 {
  "message": "Channel Deleted",
  "response": {
    "channel_id": "string",
    "transactions_id": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Delete Payload

channel_id
required
string
is_force
boolean

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string",
  • "is_force": true
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel ID

Channel ID API

Sample INPUT

// Query params

?channel_id="string"

Sample OUTPUT

 {
  "message": "Channel ID",
  "response": {
    "channel_favorite": true,
    "channel_id": "string",
    "channel_key": "string",
    "channel_name": "string",
    "channel_sid": "string",
    "channel_threshold": "string",
    "channel_threshold_duration": 0,
    "customer_id": "string",
    "device_id": "string",
    "is_active": true,
    "is_auto_recovery": true,
    "is_purge": true,
    "is_storage": true,
    "is_verified": true,
    "pipeline_id": "string",
    "site_id": "string",
    "source_id": "string",
    "transaction_id": "string",
    "usecase_key": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
channel_id
required
string

Channel ID Payload

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Channel List

Channel List By Key API

Sample INPUT

// Query params

{
  "usecase_key": "string"
}

Sample OUTPUT

 {
  "message": "Channel List",
  "response": [
    {
      "channel_favorite": true,
      "channel_id": "string",
      "channel_key": "string",
      "channel_name": "string",
      "channel_sid": "string",
      "channel_threshold": "string",
      "channel_threshold_duration": 0,
      "customer_id": "string",
      "device_id": "string",
      "is_active": true,
      "is_auto_recovery": true,
      "is_purge": true,
      "is_storage": true,
      "is_verified": true,
      "pipeline_id": "string",
      "site_id": "string",
      "source_id": "string",
      "transaction_id": "string",
      "usecase_key": "string"
    }
  ],
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel List Payload

nimble_id
string
site_id
string
usecase_key
string

Responses

Request samples

Content type
application/json
{
  • "nimble_id": "string",
  • "site_id": "string",
  • "usecase_key": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

Channel Refactor

Channel Refactor API

Sample INPUT

{
  "nimble_id": "string",
  "device_id": "string"
}

Sample OUTPUT

 {
  "message": "Channel Updated",
  "response": {
    "transactions_id": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Refactor Payload

device_id
required
string
nimble_id
required
string

Responses

Request samples

Content type
application/json
{
  • "device_id": "string",
  • "nimble_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel Revive

Channel Revive API

Sample INPUT

{
  "channel_id": "string"
}

Sample OUTPUT

 {
  "message": "Channel Created",
  "response": {
    "channel_id": "string",
    "transactions_id": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Revive Payload

channel_id
required
string
is_force
boolean

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string",
  • "is_force": true
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel Status

Channel Status API

Sample INPUT

// Query params

{
  "channel_id": "string"
}

Sample OUTPUT

 {
  "message": "Channel Status",
  "response": {
    "is_active": true,
    "is_storage": true,
    "is_verified": true
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
channel_id
required
string

Channel ID Payload

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Channel Troubleshoot

Channel Troubleshoot API

Sample INPUT

{
  "channel_id": "string"
}

Sample OUTPUT

 {
  "message": "Channel troubleshoot",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
channel_id
required
string

Channel Troubleshoot Payload

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel UnAssign

Channel UnAssign API

Sample INPUT

{
  "channel_id": [
    "string"
  ],
  "user_id": "string"
}

Sample OUTPUT

 {
  "message": "Channel un-assigned",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel UnAssign Payload

channel_id
required
Array of strings
user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": [
    ],
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Channel Update

Channel Update API

Sample INPUT

{
  "channel_id": "string",
  "channel_name": "string",
  "is_auto_recovery": true,
  "is_force": true,
  "pipeline_elements": {
    "additionalProp1": {}
  },
  "pipeline_id": "string",
  "usecase_key": "string"
}

Sample OUTPUT

 {
  "message": "Channel updated",
  "response":  {},
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Update Payload

channel_id
required
string
channel_name
required
string
object (channel.pipelineUpdateReq)
is_auto_recovery
required
boolean
is_force
boolean
usecase_key
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string",
  • "channel_name": "string",
  • "channel_pipeline": {
    },
  • "is_auto_recovery": true,
  • "is_force": true,
  • "usecase_key": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Channel Update Notification Count

Channel Update API

Sample INPUT

{
  "channel_id": "string",
  "channel_name": "string",
  "is_auto_recovery": true,
  "is_force": true,
  "pipeline_elements": {
    "additionalProp1": {}
  },
  "pipeline_id": "string",
  "usecase_key": "string"
}

Sample OUTPUT

 {
  "message": "Channel updated",
  "response":  {},
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Channel Revive Payload

channel_id
required
string
channel_name
required
string
object (channel.pipelineUpdateReq)
is_auto_recovery
required
boolean
is_force
boolean
usecase_key
required
string

Responses

Request samples

Content type
application/json
{
  • "channel_id": "string",
  • "channel_name": "string",
  • "channel_pipeline": {
    },
  • "is_auto_recovery": true,
  • "is_force": true,
  • "usecase_key": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Configuration

Backup State

Config Backup State API.

run_type options

  • 1 for Docker backup
  • 2 for local backup

Note: For local backup, mongo, mongodump & mongorestore executables are required in $PATH.

Sample INPUT

{
  "run_type": 1
}

Sample OUTPUT

{
  "message": "State backup completed",
  "response": null,
  "response_code": 200
}
query Parameters
run_type
required
string

Backup run type, [1] Docker, [2] Local

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Is INIT

Config Init API.

Sample OUTPUT

  {
    "message": "Init Settings",
    "response": {},
    "response_code": 200
  } 
Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": { },
  • "response_code": 0
}

Patch State

Config Patch State API.

run_type options

  • 1 for Docker patch
  • 2 for local patch

Note: For local patch, mongo, mongodump & mongorestore executables are required in $PATH.

Sample INPUT

{
  "run_type": 1
}

Sample OUTPUT

{
  "message": "State patch completed",
  "response": null,
  "response_code": 200
}
query Parameters
run_type
required
string

Patch run type, [1] Docker, [2] Local

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Reset STS

Access control list

Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Restore State

Config Restore State API.

run_type options

  • 1 for Docker restore
  • 2 for local restore

Note: For local restore, mongo, mongodump & mongorestore executables are required in $PATH.

Sample INPUT

{
  "file_": "",
  "run_type": 1
}

Sample OUTPUT

{
  "message": "State restore completed",
  "response": null,
  "response_code": 200
}
query Parameters
run_type
required
string

Restore run type, [1] Docker, [2] Local

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Get SMS Config

Get SMS Config API.

Sample OUTPUT

{
    "message": "SMS Settings",
    "response": {
        "sms_auth_key": "string",
        "sms_auth_token": "string",
        "sms_provider": "string",
        "sms_from": "string",
        "sms_to": "string"
    },
    "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
is_secret
required
boolean

Reveal Secret

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Update SMS Config

Update SMS Config API.

Sample INPUT

{
  "sms_auth_key": "string",
  "sms_auth_token": "string",
  "sms_provider": "string",
  "sms_from": "string",
  "sms_to": "string"
}

Sample OUTPUT

{
  "message": "SMS settings updated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Get SMTP Config

Get SMS Config API.

Sample OUTPUT

{
  "message": "SMTP Settings",
  "response": {
    "smtp_attachment": true,
    "smtp_auth": true,
    "smtp_from": "string",
    "smtp_host": "string",
    "smtp_password": "string",
    "smtp_port": 0,
    "smtp_to": "string",
    "smtp_username": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
is_secret
required
boolean

Reveal Secret

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Update SMTP Config

Update SMTP Config API.

Sample INPUT

{
  "smtp_attachment": true,
  "smtp_auth": true,
  "smtp_from": "string",
  "smtp_host": "string",
  "smtp_password": "string",
  "smtp_port": 0,
  "smtp_to": "string",
  "smtp_username": "string"
}

Sample OUTPUT

{
  "message": "SMTP settings updated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Status Storage

Storage Information + Account Information

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Status Storage

Storage Information

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Storage Delete

Storage Delete

Sample INPUT

// Query params

{
  "channel_id": "string"
}
query Parameters
channel_id
required
string

Channel Storage Delete Payload

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer

Customer Assign

Customer Site Assign API.

Sample INPUT

{
  "customer_id": "string",
  "site_ids": [
    "string"
  ]
}

Sample OUTPUT

{
  "message": "Assigned site(s) to customer",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer Assign Payload

customer_id
required
Array of strings
user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "customer_id": [
    ],
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer Bundle View

Customer View API

Sample OUTPUT Type 1

{
  "message": "string",
  "response": {
    "message": "string",
    "response": [
      {
        "bundle_id": "string",
        "bundle_key": "string",
        "bundle_name": "string",
        "bundle_usecases": [
          {
            "bundle_key": "string",
            "is_available": true,
            "usecase_background_color": "string",
            "usecase_channels": [
              {
                "channel_favorite": true,
                "channel_id": "string",
                "channel_key": "string",
                "channel_name": "string",
                "channel_sid": "string",
                "channel_threshold_duration": 0,
                "device_id": "string",
                "is_active": true,
                "is_auto_recovery": true,
                "is_purge": true,
                "is_storage": true,
                "is_verified": true,
                "nimble_id": "string",
                "pipeline_id": "string",
                "site_id": "string",
                "source_id": "string",
                "usecase_icon": "string",
                "usecase_id": "string",
                "usecase_key": "string",
                "usecase_meta_key": [
                  {
                    "additionalProp1": "string",
                    "additionalProp2": "string",
                    "additionalProp3": "string"
                  }
                ],
                "usecase_name": "string"
              }
            ],
            "usecase_component_key": "string",
            "usecase_desc": "string",
            "usecase_icon": "string",
            "usecase_id": "string",
            "usecase_key": "string",
            "usecase_meta_key": [
              {
                "additionalProp1": "string",
                "additionalProp2": "string",
                "additionalProp3": "string"
              }
            ],
            "usecase_name": "string"
          }
        ]
      }
    ]
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
customer_id
required
string

Customer ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Customer Create

Customer Create API.

At create customer customer_sites is an empty array, or it has to have a valid list of site_ids

Sample INPUT

{
  "customer_address": {
    "customer_area": "string",
    "customer_city": "string",
    "customer_country": "string",
    "customer_state": "string",
    "customer_street": "string",
    "customer_unit": "string",
    "customer_zip": "string"
  },
  "customer_contact": [
    "string"
  ],
  "customer_description": "string",
  "customer_icon": "string",
  "customer_id": "string",
  "customer_key": "string",
  "customer_name": "string",
  "customer_sites": [],
  "customer_type": "string",
  "organization_id": "string"
}

Sample OUTPUT

{
  "message": "Customer Created",
  "response": null,
  "response_code": 201
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer Create Payload

required
object (customer.customerAddress)
customer_contact
Array of strings
customer_description
string
customer_icon
required
string
customer_image
required
string
customer_key
required
string
customer_name
required
string
customer_sites
Array of strings
customer_type
string
organization_id
required
string

Responses

Request samples

Content type
application/json
{
  • "customer_address": {
    },
  • "customer_contact": [
    ],
  • "customer_description": "string",
  • "customer_icon": "string",
  • "customer_image": "string",
  • "customer_key": "string",
  • "customer_name": "string",
  • "customer_sites": [
    ],
  • "customer_type": "string",
  • "organization_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer Delete

Customer Delete API.

Sample INPUT

{
    "customer_id": "string"
}

Sample OUTPUT

{
    "message": "Customer deleted",
    "response": null,
    "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer Delete Payload

customer_id
required
string

Responses

Request samples

Content type
application/json
{
  • "customer_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer ID

Customer ID API.

Sample INPUT

// Query params

{
  "customer_id": "string"
}

Sample OUTPUT

{
  "message": "Customer ID",
  "response": {
    "customer_address": {
      "customer_area": "string",
      "customer_city": "string",
      "customer_country": "string",
      "customer_state": "string",
      "customer_street": "string",
      "customer_unit": "string",
      "customer_zip": "string"
    },
    "customer_contact": [
      "string"
    ],
    "customer_description": "string",
    "customer_icon": "string",
    "customer_id": "string",
    "customer_key": "string",
    "customer_name": "string",
    "customer_sites": [
      "string"
    ],
    "customer_type": "string",
    "organization_id": "string"
  },
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
customer_id
required
string

Customer ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": {
    },
  • "response_code": 0
}

Customer List

Customer List API.

Sample INPUT

// Query params

{
  "organization_id": "string",
  "is_default": "string"
}

Sample OUTPUT

{
  "message": "Customer List",
  "response": [
    {
      "customer_address": {
        "customer_area": "string",
        "customer_city": "string",
        "customer_country": "string",
        "customer_state": "string",
        "customer_street": "string",
        "customer_unit": "string",
        "customer_zip": "string"
      },
      "customer_contact": [
        "string"
      ],
      "customer_description": "string",
      "customer_icon": "string",
      "customer_id": "string",
      "customer_key": "string",
      "customer_name": "string",
      "customer_sites": [
        "string"
      ],
      "customer_type": "string",
      "organization_id": "string"
    }
  ],
  "response_code": 200
}
Authorizations:
OAuth2Password
query Parameters
organization_id
required
string

Organization ID

is_default
string

Includes Default Customer

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": [
    ],
  • "response_code": 0
}

Customer Site Assign

Customer Site Assign API.

Sample INPUT

{
  "customer_id": "string",
  "site_ids": [
    "string"
  ]
}

Sample OUTPUT

{
  "message": "Assigned site(s) to customer",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer Site Assign Payload

customer_id
required
string
site_ids
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "customer_id": "string",
  • "site_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer Site Unassign

Customer Site Unassign API.

Sample INPUT

{
  "customer_id": "string",
  "site_ids": [
    "string"
  ]
}

Sample OUTPUT

{
    "message": "Unassigned site(s) to customer",
    "response": null,
    "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer Site Assign Payload

customer_id
required
string
site_ids
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "customer_id": "string",
  • "site_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer Assign

Customer Site Unassign API.

Sample INPUT

{
  "customer_id": "string",
  "site_ids": [
    "string"
  ]
}

Sample OUTPUT

{
    "message": "Unassigned site(s) to customer",
    "response": null,
    "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer UnAssign Payload

customer_id
required
Array of strings
user_id
required
string

Responses

Request samples

Content type
application/json
{
  • "customer_id": [
    ],
  • "user_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer Update

Customer Update API.

Sample INPUT

{
  "customer_address": {
    "customer_area": "string",
    "customer_city": "string",
    "customer_country": "string",
    "customer_state": "string",
    "customer_street": "string",
    "customer_unit": "string",
    "customer_zip": "string"
  },
  "customer_contact": [
    "string"
  ],
  "customer_description": "string",
  "customer_icon": "string",
  "customer_id": "string",
  "customer_key": "string",
  "customer_name": "string",
  "customer_sites": [
    "string"
  ],
  "customer_type": "string",
  "organization_id": "string"
}

Sample OUTPUT

{
  "message": "Customer updated",
  "response": null,
  "response_code": 200
}
Authorizations:
OAuth2Password
Request Body schema: application/json

Customer Update Payload

required
object (customer.customerAddress)
customer_contact
Array of strings
customer_description
string
customer_icon
required
string
customer_id
required
string
customer_image
required
string
customer_key
required
string
customer_name
required
string
customer_sites
Array of strings
customer_type
string
organization_id
required
string

Responses

Request samples

Content type
application/json
{
  • "customer_address": {
    },
  • "customer_contact": [
    ],
  • "customer_description": "string",
  • "customer_icon": "string",
  • "customer_id": "string",
  • "customer_image": "string",
  • "customer_key": "string",
  • "customer_name": "string",
  • "customer_sites": [
    ],
  • "customer_type": "string",
  • "organization_id": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "response": null,
  • "response_code": 0
}

Customer View

Customer View API

Sample INPUT

// Query params

{
  "customer_id": "string",
  "type": 1
}

Sample OUTPUT Type 1

{
  "message": "Customer site map",
  "response": [
    {
      "site_address": {
        "site_area": "string",
        "site_city": "string",
        "site_country": "string",
        "site_geolocation": {
          "lat": 0,
          "long": 0
        },
        "site_state": "string",
        "site_street": "string",
        "site_unit": "string",
        "site_zip": "string"
      },
      "site_description": "string",
      "site_devices": [
        {
          "device_id": "string",
          "device_identifier": "string",
          "device_name": "string",
          "device_source": [
            {
              "source_address": "string"