S 7 Connection Controller

get
Authorizations
Path parameters
connectionIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/{connectionId} HTTP/1.1
Host: inscada.cloud
Accept: */*

{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "projectId": "text",
  "name": "text",
  "protocol": "Modbus TCP",
  "ip": "text",
  "dsc": "text",
  "port": 1,
  "slot": 1,
  "rack": 1,
  "type": "PG",
  "timeout": 1,
  "owner": "text"
}
put
Authorizations
Path parameters
connectionIdstringRequired
Body
creationDatestring · date-timeRead-onlyOptional
lastModifiedBystringRead-onlyOptional
createdBystringRead-onlyOptional
lastModifiedDatestring · date-timeRead-onlyOptional
idstringOptional
projectIdstringOptional
namestring · max: 100Required
protocolstring · enumRequiredPossible values:
ipstring · max: 50Required
dscstring · max: 255Optional
portinteger · int32 · max: 65535Required
slotinteger · int32Required
rackinteger · int32Required
typestring · enumRequiredPossible values:
timeoutinteger · int32 · min: 10Optional
ownerstringOptional
Responses
204
No Content
put
PUT /api/protocols/s7/connections/{connectionId} HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 161

{
  "id": "text",
  "projectId": "text",
  "name": "text",
  "protocol": "Modbus TCP",
  "ip": "text",
  "dsc": "text",
  "port": 1,
  "slot": 1,
  "rack": 1,
  "type": "PG",
  "timeout": 1,
  "owner": "text"
}
No content
delete
Authorizations
Path parameters
connectionIdstringRequired
Responses
204
No Content
delete
DELETE /api/protocols/s7/connections/{connectionId} HTTP/1.1
Host: inscada.cloud
Accept: */*

No content
get
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/{connectionId}/devices/{deviceId} HTTP/1.1
Host: inscada.cloud
Accept: */*

{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "dsc": "text",
  "name": "text",
  "connectionId": "text",
  "scanType": "Periodic",
  "scanTime": 1
}
put
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
Body
creationDatestring · date-timeRead-onlyOptional
lastModifiedBystringRead-onlyOptional
createdBystringRead-onlyOptional
lastModifiedDatestring · date-timeRead-onlyOptional
idstringOptional
dscstring · max: 255Optional
namestring · max: 100Required
connectionIdstringOptional
scanTypestring · enumRequiredPossible values:
scanTimeinteger · int32 · min: 1Required
Responses
204
No Content
put
PUT /api/protocols/s7/connections/{connectionId}/devices/{deviceId} HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "id": "text",
  "dsc": "text",
  "name": "text",
  "connectionId": "text",
  "scanType": "Periodic",
  "scanTime": 1
}
No content
delete
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
Responses
204
No Content
delete
DELETE /api/protocols/s7/connections/{connectionId}/devices/{deviceId} HTTP/1.1
Host: inscada.cloud
Accept: */*

No content
get
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
frameIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/{connectionId}/devices/{deviceId}/frames/{frameId} HTTP/1.1
Host: inscada.cloud
Accept: */*

{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "isWritable": true,
  "name": "text",
  "minutesOffset": 1,
  "isReadable": true,
  "dsc": "text",
  "scanTimeFactor": 1,
  "deviceId": "text",
  "quantity": 1,
  "type": "System Information (Caller)",
  "dbNumber": 1,
  "startAddress": 1
}
put
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
frameIdstringRequired
Body
creationDatestring · date-timeRead-onlyOptional
lastModifiedBystringRead-onlyOptional
createdBystringRead-onlyOptional
lastModifiedDatestring · date-timeRead-onlyOptional
idstringOptional
isWritablebooleanRequired
namestring · max: 100Required
minutesOffsetinteger · int32Optional
isReadablebooleanRequired
dscstring · max: 255Optional
scanTimeFactorinteger · int32Optional
deviceIdstringOptional
quantityinteger · int32 · min: 1Required
typestring · enumRequiredPossible values:
dbNumberinteger · int32Optional
startAddressinteger · int32Required
Responses
204
No Content
put
PUT /api/protocols/s7/connections/{connectionId}/devices/{deviceId}/frames/{frameId} HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "id": "text",
  "isWritable": true,
  "name": "text",
  "minutesOffset": 1,
  "isReadable": true,
  "dsc": "text",
  "scanTimeFactor": 1,
  "deviceId": "text",
  "quantity": 1,
  "type": "System Information (Caller)",
  "dbNumber": 1,
  "startAddress": 1
}
No content
delete
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
frameIdstringRequired
Responses
204
No Content
delete
DELETE /api/protocols/s7/connections/{connectionId}/devices/{deviceId}/frames/{frameId} HTTP/1.1
Host: inscada.cloud
Accept: */*

No content
get
Authorizations
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "projectId": "text",
    "name": "text",
    "protocol": "Modbus TCP",
    "ip": "text",
    "dsc": "text",
    "port": 1,
    "slot": 1,
    "rack": 1,
    "type": "PG",
    "timeout": 1,
    "owner": "text"
  }
]
post
Authorizations
Body
creationDatestring · date-timeRead-onlyOptional
lastModifiedBystringRead-onlyOptional
createdBystringRead-onlyOptional
lastModifiedDatestring · date-timeRead-onlyOptional
idstringOptional
projectIdstringOptional
namestring · max: 100Required
protocolstring · enumRequiredPossible values:
ipstring · max: 50Required
dscstring · max: 255Optional
portinteger · int32 · max: 65535Required
slotinteger · int32Required
rackinteger · int32Required
typestring · enumRequiredPossible values:
timeoutinteger · int32 · min: 10Optional
ownerstringOptional
Responses
200
OK
*/*
post
POST /api/protocols/s7/connections HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 161

{
  "id": "text",
  "projectId": "text",
  "name": "text",
  "protocol": "Modbus TCP",
  "ip": "text",
  "dsc": "text",
  "port": 1,
  "slot": 1,
  "rack": 1,
  "type": "PG",
  "timeout": 1,
  "owner": "text"
}
{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "projectId": "text",
  "name": "text",
  "protocol": "Modbus TCP",
  "ip": "text",
  "dsc": "text",
  "port": 1,
  "slot": 1,
  "rack": 1,
  "type": "PG",
  "timeout": 1,
  "owner": "text"
}
get
Authorizations
Path parameters
connectionIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/{connectionId}/devices HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "dsc": "text",
    "name": "text",
    "connectionId": "text",
    "scanType": "Periodic",
    "scanTime": 1
  }
]
post
Authorizations
Path parameters
connectionIdstringRequired
Body
creationDatestring · date-timeRead-onlyOptional
lastModifiedBystringRead-onlyOptional
createdBystringRead-onlyOptional
lastModifiedDatestring · date-timeRead-onlyOptional
idstringOptional
dscstring · max: 255Optional
namestring · max: 100Required
connectionIdstringOptional
scanTypestring · enumRequiredPossible values:
scanTimeinteger · int32 · min: 1Required
Responses
200
OK
*/*
post
POST /api/protocols/s7/connections/{connectionId}/devices HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "id": "text",
  "dsc": "text",
  "name": "text",
  "connectionId": "text",
  "scanType": "Periodic",
  "scanTime": 1
}
{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "dsc": "text",
  "name": "text",
  "connectionId": "text",
  "scanType": "Periodic",
  "scanTime": 1
}
get
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/{connectionId}/devices/{deviceId}/frames HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "isWritable": true,
    "name": "text",
    "minutesOffset": 1,
    "isReadable": true,
    "dsc": "text",
    "scanTimeFactor": 1,
    "deviceId": "text",
    "quantity": 1,
    "type": "System Information (Caller)",
    "dbNumber": 1,
    "startAddress": 1
  }
]
post
Authorizations
Path parameters
connectionIdstringRequired
deviceIdstringRequired
Body
creationDatestring · date-timeRead-onlyOptional
lastModifiedBystringRead-onlyOptional
createdBystringRead-onlyOptional
lastModifiedDatestring · date-timeRead-onlyOptional
idstringOptional
isWritablebooleanRequired
namestring · max: 100Required
minutesOffsetinteger · int32Optional
isReadablebooleanRequired
dscstring · max: 255Optional
scanTimeFactorinteger · int32Optional
deviceIdstringOptional
quantityinteger · int32 · min: 1Required
typestring · enumRequiredPossible values:
dbNumberinteger · int32Optional
startAddressinteger · int32Required
Responses
200
OK
*/*
post
POST /api/protocols/s7/connections/{connectionId}/devices/{deviceId}/frames HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "id": "text",
  "isWritable": true,
  "name": "text",
  "minutesOffset": 1,
  "isReadable": true,
  "dsc": "text",
  "scanTimeFactor": 1,
  "deviceId": "text",
  "quantity": 1,
  "type": "System Information (Caller)",
  "dbNumber": 1,
  "startAddress": 1
}
{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "isWritable": true,
  "name": "text",
  "minutesOffset": 1,
  "isReadable": true,
  "dsc": "text",
  "scanTimeFactor": 1,
  "deviceId": "text",
  "quantity": 1,
  "type": "System Information (Caller)",
  "dbNumber": 1,
  "startAddress": 1
}
post
Authorizations
Path parameters
connectionIdstringRequired
Body
prefixstringOptional
suffixstringOptional
deviceTemplateIdstringOptional
Responses
204
No Content
post
POST /api/protocols/s7/connections/{connectionId}/devices/generate HTTP/1.1
Host: inscada.cloud
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "prefix": "text",
  "suffix": "text",
  "deviceTemplateId": "text"
}
No content
get
Authorizations
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/frames HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "isWritable": true,
    "name": "text",
    "minutesOffset": 1,
    "isReadable": true,
    "dsc": "text",
    "scanTimeFactor": 1,
    "deviceId": "text",
    "quantity": 1,
    "type": "System Information (Caller)",
    "dbNumber": 1,
    "startAddress": 1
  }
]
get
Authorizations
Query parameters
projectIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/frames/by-project HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "isWritable": true,
    "name": "text",
    "minutesOffset": 1,
    "isReadable": true,
    "dsc": "text",
    "scanTimeFactor": 1,
    "deviceId": "text",
    "quantity": 1,
    "type": "System Information (Caller)",
    "dbNumber": 1,
    "startAddress": 1
  }
]
get
Authorizations
Path parameters
frameIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/frame/{frameId} HTTP/1.1
Host: inscada.cloud
Accept: */*

{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "isWritable": true,
  "name": "text",
  "minutesOffset": 1,
  "isReadable": true,
  "dsc": "text",
  "scanTimeFactor": 1,
  "deviceId": "text",
  "quantity": 1,
  "type": "System Information (Caller)",
  "dbNumber": 1,
  "startAddress": 1
}
get
Authorizations
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/devices HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "dsc": "text",
    "name": "text",
    "connectionId": "text",
    "scanType": "Periodic",
    "scanTime": 1
  }
]
get
Authorizations
Query parameters
projectIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/devices/by-project HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "dsc": "text",
    "name": "text",
    "connectionId": "text",
    "scanType": "Periodic",
    "scanTime": 1
  }
]
get
Authorizations
Path parameters
deviceIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/device/{deviceId} HTTP/1.1
Host: inscada.cloud
Accept: */*

{
  "creationDate": "2025-07-05T20:00:54.718Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-07-05T20:00:54.718Z",
  "id": "text",
  "dsc": "text",
  "name": "text",
  "connectionId": "text",
  "scanType": "Periodic",
  "scanTime": 1
}
get
Authorizations
Query parameters
projectIdstringRequired
Responses
200
OK
*/*
get
GET /api/protocols/s7/connections/by-project HTTP/1.1
Host: inscada.cloud
Accept: */*

[
  {
    "creationDate": "2025-07-05T20:00:54.718Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-07-05T20:00:54.718Z",
    "id": "text",
    "projectId": "text",
    "name": "text",
    "protocol": "Modbus TCP",
    "ip": "text",
    "dsc": "text",
    "port": 1,
    "slot": 1,
    "rack": 1,
    "type": "PG",
    "timeout": 1,
    "owner": "text"
  }
]
delete
Authorizations
Query parameters
connectionIdsstring[]Required
Responses
204
No Content
delete
DELETE /api/protocols/s7/connections/multi/by-ids HTTP/1.1
Host: inscada.cloud
Accept: */*

No content
delete
Authorizations
Query parameters
frameIdsstring[]Required
Responses
204
No Content
delete
DELETE /api/protocols/s7/connections/frames/multi/by-ids HTTP/1.1
Host: inscada.cloud
Accept: */*

No content
delete
Authorizations
Query parameters
deviceIdsstring[]Required
Responses
204
No Content
delete
DELETE /api/protocols/s7/connections/devices/multi/by-ids HTTP/1.1
Host: inscada.cloud
Accept: */*

No content
PreviousS 7 Template ControllerNextOpc Ua Variable Controller