S 7 Variable Controller | Version 2022

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables

GET /api/protocols/s7/variables HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

[
  {
    "creationDate": "2025-12-17T18:03:05.037Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-12-17T18:03:05.037Z",
    "id": "text",
    "keepLastValues": true,
    "unit": "text",
    "engZeroScale": 1,
    "fractionalDigitCount": 1,
    "name": "text",
    "logExpressionId": "text",
    "logType": "No Log",
    "logExpressionCode": "text",
    "valueExpressionCode": "text",
    "valueExpressionId": "text",
    "isPulseOff": true,
    "frameId": "text",
    "setMinValue": 1,
    "pulseOffDuration": 1,
    "code": "text",
    "engFullScale": 1,
    "pulseOnDuration": 1,
    "logThreshold": 1,
    "rawFullScale": 1,
    "isPulseOn": true,
    "valueExpressionType": "NONE",
    "logMaxValue": 1,
    "setMaxValue": 1,
    "logMinValue": 1,
    "isActive": true,
    "projectId": "text",
    "rawZeroScale": 1,
    "logPeriod": 1,
    "dsc": "text",
    "bitOffset": 1,
    "maxLen": 1,
    "startAddress": 1,
    "type": "BIT",
    "connectionId": "text",
    "deviceId": "text"
  }
]

post

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Body

creationDatestring · date-timeRead-onlyOptional

lastModifiedBystringRead-onlyOptional

createdBystringRead-onlyOptional

lastModifiedDatestring · date-timeRead-onlyOptional

idstringOptional

keepLastValuesbooleanRequired

unitstringOptional

engZeroScalenumber · doubleOptional

fractionalDigitCountinteger · int32Optional

namestring · max: 100Required

logExpressionIdstringOptional

logTypestring · enumOptionalPossible values:

logExpressionCodestring · max: 4000Optional

valueExpressionCodestring · max: 4000Optional

valueExpressionIdstringOptional

isPulseOffbooleanRequired

frameIdstringOptional

setMinValuenumber · doubleOptional

pulseOffDurationinteger · int32Optional

codestring · max: 20Optional

engFullScalenumber · doubleOptional

pulseOnDurationinteger · int32Optional

logThresholdnumber · doubleOptional

rawFullScalenumber · doubleOptional

isPulseOnbooleanRequired

valueExpressionTypestring · enumOptionalPossible values:

logMaxValuenumber · doubleOptional

setMaxValuenumber · doubleOptional

logMinValuenumber · doubleOptional

isActivebooleanRequired

projectIdstringOptional

rawZeroScalenumber · doubleOptional

logPeriodinteger · int32 · min: 1Optional

dscstring · max: 255Optional

bitOffsetinteger · int32Optional

maxLeninteger · int32Optional

startAddressinteger · int32Required

typestring · enumRequiredPossible values:

connectionIdstringOptional

deviceIdstringOptional

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

post

/api/protocols/s7/variables

POST /api/protocols/s7/variables HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 657

{
  "id": "text",
  "keepLastValues": true,
  "unit": "text",
  "engZeroScale": 1,
  "fractionalDigitCount": 1,
  "name": "text",
  "logExpressionId": "text",
  "logType": "No Log",
  "logExpressionCode": "text",
  "valueExpressionCode": "text",
  "valueExpressionId": "text",
  "isPulseOff": true,
  "frameId": "text",
  "setMinValue": 1,
  "pulseOffDuration": 1,
  "code": "text",
  "engFullScale": 1,
  "pulseOnDuration": 1,
  "logThreshold": 1,
  "rawFullScale": 1,
  "isPulseOn": true,
  "valueExpressionType": "NONE",
  "logMaxValue": 1,
  "setMaxValue": 1,
  "logMinValue": 1,
  "isActive": true,
  "projectId": "text",
  "rawZeroScale": 1,
  "logPeriod": 1,
  "dsc": "text",
  "bitOffset": 1,
  "maxLen": 1,
  "startAddress": 1,
  "type": "BIT",
  "connectionId": "text",
  "deviceId": "text"
}

{
  "creationDate": "2025-12-17T18:03:05.037Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-12-17T18:03:05.037Z",
  "id": "text",
  "keepLastValues": true,
  "unit": "text",
  "engZeroScale": 1,
  "fractionalDigitCount": 1,
  "name": "text",
  "logExpressionId": "text",
  "logType": "No Log",
  "logExpressionCode": "text",
  "valueExpressionCode": "text",
  "valueExpressionId": "text",
  "isPulseOff": true,
  "frameId": "text",
  "setMinValue": 1,
  "pulseOffDuration": 1,
  "code": "text",
  "engFullScale": 1,
  "pulseOnDuration": 1,
  "logThreshold": 1,
  "rawFullScale": 1,
  "isPulseOn": true,
  "valueExpressionType": "NONE",
  "logMaxValue": 1,
  "setMaxValue": 1,
  "logMinValue": 1,
  "isActive": true,
  "projectId": "text",
  "rawZeroScale": 1,
  "logPeriod": 1,
  "dsc": "text",
  "bitOffset": 1,
  "maxLen": 1,
  "startAddress": 1,
  "type": "BIT",
  "connectionId": "text",
  "deviceId": "text"
}

put

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Bodyobject[]

creationDatestring · date-timeRead-onlyOptional

lastModifiedBystringRead-onlyOptional

createdBystringRead-onlyOptional

lastModifiedDatestring · date-timeRead-onlyOptional

idstringOptional

keepLastValuesbooleanRequired

unitstringOptional

engZeroScalenumber · doubleOptional

fractionalDigitCountinteger · int32Optional

namestring · max: 100Required

logExpressionIdstringOptional

logTypestring · enumOptionalPossible values:

logExpressionCodestring · max: 4000Optional

valueExpressionCodestring · max: 4000Optional

valueExpressionIdstringOptional

isPulseOffbooleanRequired

frameIdstringOptional

setMinValuenumber · doubleOptional

pulseOffDurationinteger · int32Optional

codestring · max: 20Optional

engFullScalenumber · doubleOptional

pulseOnDurationinteger · int32Optional

logThresholdnumber · doubleOptional

rawFullScalenumber · doubleOptional

isPulseOnbooleanRequired

valueExpressionTypestring · enumOptionalPossible values:

logMaxValuenumber · doubleOptional

setMaxValuenumber · doubleOptional

logMinValuenumber · doubleOptional

isActivebooleanRequired

projectIdstringOptional

rawZeroScalenumber · doubleOptional

logPeriodinteger · int32 · min: 1Optional

dscstring · max: 255Optional

bitOffsetinteger · int32Optional

maxLeninteger · int32Optional

startAddressinteger · int32Required

typestring · enumRequiredPossible values:

connectionIdstringOptional

deviceIdstringOptional

Responses

204

No Content

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

put

/api/protocols/s7/variables

PUT /api/protocols/s7/variables HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 659

[
  {
    "id": "text",
    "keepLastValues": true,
    "unit": "text",
    "engZeroScale": 1,
    "fractionalDigitCount": 1,
    "name": "text",
    "logExpressionId": "text",
    "logType": "No Log",
    "logExpressionCode": "text",
    "valueExpressionCode": "text",
    "valueExpressionId": "text",
    "isPulseOff": true,
    "frameId": "text",
    "setMinValue": 1,
    "pulseOffDuration": 1,
    "code": "text",
    "engFullScale": 1,
    "pulseOnDuration": 1,
    "logThreshold": 1,
    "rawFullScale": 1,
    "isPulseOn": true,
    "valueExpressionType": "NONE",
    "logMaxValue": 1,
    "setMaxValue": 1,
    "logMinValue": 1,
    "isActive": true,
    "projectId": "text",
    "rawZeroScale": 1,
    "logPeriod": 1,
    "dsc": "text",
    "bitOffset": 1,
    "maxLen": 1,
    "startAddress": 1,
    "type": "BIT",
    "connectionId": "text",
    "deviceId": "text"
  }
]

No content

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Path parameters

variableIdstringRequired

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables/{variableId}

GET /api/protocols/s7/variables/{variableId} HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

{
  "creationDate": "2025-12-17T18:03:05.037Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-12-17T18:03:05.037Z",
  "id": "text",
  "keepLastValues": true,
  "unit": "text",
  "engZeroScale": 1,
  "fractionalDigitCount": 1,
  "name": "text",
  "logExpressionId": "text",
  "logType": "No Log",
  "logExpressionCode": "text",
  "valueExpressionCode": "text",
  "valueExpressionId": "text",
  "isPulseOff": true,
  "frameId": "text",
  "setMinValue": 1,
  "pulseOffDuration": 1,
  "code": "text",
  "engFullScale": 1,
  "pulseOnDuration": 1,
  "logThreshold": 1,
  "rawFullScale": 1,
  "isPulseOn": true,
  "valueExpressionType": "NONE",
  "logMaxValue": 1,
  "setMaxValue": 1,
  "logMinValue": 1,
  "isActive": true,
  "projectId": "text",
  "rawZeroScale": 1,
  "logPeriod": 1,
  "dsc": "text",
  "bitOffset": 1,
  "maxLen": 1,
  "startAddress": 1,
  "type": "BIT",
  "connectionId": "text",
  "deviceId": "text"
}

put

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Path parameters

variableIdstringRequired

Body

creationDatestring · date-timeRead-onlyOptional

lastModifiedBystringRead-onlyOptional

createdBystringRead-onlyOptional

lastModifiedDatestring · date-timeRead-onlyOptional

idstringOptional

keepLastValuesbooleanRequired

unitstringOptional

engZeroScalenumber · doubleOptional

fractionalDigitCountinteger · int32Optional

namestring · max: 100Required

logExpressionIdstringOptional

logTypestring · enumOptionalPossible values:

logExpressionCodestring · max: 4000Optional

valueExpressionCodestring · max: 4000Optional

valueExpressionIdstringOptional

isPulseOffbooleanRequired

frameIdstringOptional

setMinValuenumber · doubleOptional

pulseOffDurationinteger · int32Optional

codestring · max: 20Optional

engFullScalenumber · doubleOptional

pulseOnDurationinteger · int32Optional

logThresholdnumber · doubleOptional

rawFullScalenumber · doubleOptional

isPulseOnbooleanRequired

valueExpressionTypestring · enumOptionalPossible values:

logMaxValuenumber · doubleOptional

setMaxValuenumber · doubleOptional

logMinValuenumber · doubleOptional

isActivebooleanRequired

projectIdstringOptional

rawZeroScalenumber · doubleOptional

logPeriodinteger · int32 · min: 1Optional

dscstring · max: 255Optional

bitOffsetinteger · int32Optional

maxLeninteger · int32Optional

startAddressinteger · int32Required

typestring · enumRequiredPossible values:

connectionIdstringOptional

deviceIdstringOptional

Responses

204

No Content

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

put

/api/protocols/s7/variables/{variableId}

PUT /api/protocols/s7/variables/{variableId} HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 657

{
  "id": "text",
  "keepLastValues": true,
  "unit": "text",
  "engZeroScale": 1,
  "fractionalDigitCount": 1,
  "name": "text",
  "logExpressionId": "text",
  "logType": "No Log",
  "logExpressionCode": "text",
  "valueExpressionCode": "text",
  "valueExpressionId": "text",
  "isPulseOff": true,
  "frameId": "text",
  "setMinValue": 1,
  "pulseOffDuration": 1,
  "code": "text",
  "engFullScale": 1,
  "pulseOnDuration": 1,
  "logThreshold": 1,
  "rawFullScale": 1,
  "isPulseOn": true,
  "valueExpressionType": "NONE",
  "logMaxValue": 1,
  "setMaxValue": 1,
  "logMinValue": 1,
  "isActive": true,
  "projectId": "text",
  "rawZeroScale": 1,
  "logPeriod": 1,
  "dsc": "text",
  "bitOffset": 1,
  "maxLen": 1,
  "startAddress": 1,
  "type": "BIT",
  "connectionId": "text",
  "deviceId": "text"
}

No content

delete

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Path parameters

variableIdstringRequired

Responses

204

No Content

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

delete

/api/protocols/s7/variables/{variableId}

DELETE /api/protocols/s7/variables/{variableId} HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

No content

post

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

Body

namestringOptional

typestringOptional

dscInstringOptional

projectIdstringRequired

frameIdstringOptional

connectionIdstringOptional

nameInstringOptional

deviceIdstringOptional

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

post

/api/protocols/s7/variables/filter/pages

POST /api/protocols/s7/variables/filter/pages?pageable=[object+Object] HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "name": "text",
  "type": "text",
  "dscIn": "text",
  "projectId": "text",
  "frameId": "text",
  "connectionId": "text",
  "nameIn": "text",
  "deviceId": "text"
}

{
  "totalElements": 1,
  "totalPages": 1,
  "first": true,
  "last": true,
  "size": 1,
  "content": [
    {
      "creationDate": "2025-12-17T18:03:05.037Z",
      "lastModifiedBy": "text",
      "createdBy": "text",
      "lastModifiedDate": "2025-12-17T18:03:05.037Z",
      "id": "text",
      "keepLastValues": true,
      "unit": "text",
      "engZeroScale": 1,
      "fractionalDigitCount": 1,
      "name": "text",
      "logExpressionId": "text",
      "logType": "No Log",
      "logExpressionCode": "text",
      "valueExpressionCode": "text",
      "valueExpressionId": "text",
      "isPulseOff": true,
      "frameId": "text",
      "setMinValue": 1,
      "pulseOffDuration": 1,
      "code": "text",
      "engFullScale": 1,
      "pulseOnDuration": 1,
      "logThreshold": 1,
      "rawFullScale": 1,
      "isPulseOn": true,
      "valueExpressionType": "NONE",
      "logMaxValue": 1,
      "setMaxValue": 1,
      "logMinValue": 1,
      "isActive": true,
      "projectId": "text",
      "rawZeroScale": 1,
      "logPeriod": 1,
      "dsc": "text",
      "bitOffset": 1,
      "maxLen": 1,
      "startAddress": 1,
      "type": "BIT",
      "connectionId": "text",
      "deviceId": "text"
    }
  ],
  "number": 1,
  "sort": [
    {
      "direction": "text",
      "nullHandling": "text",
      "ascending": true,
      "property": "text",
      "ignoreCase": true
    }
  ],
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "sort": [
      {
        "direction": "text",
        "nullHandling": "text",
        "ascending": true,
        "property": "text",
        "ignoreCase": true
      }
    ],
    "pageNumber": 1,
    "unpaged": true,
    "paged": true,
    "pageSize": 1
  },
  "empty": true
}

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

projectIdstringRequired

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables/pages/by-project

GET /api/protocols/s7/variables/pages/by-project?projectId=text&pageable=[object+Object] HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

{
  "totalElements": 1,
  "totalPages": 1,
  "first": true,
  "last": true,
  "size": 1,
  "content": [
    {
      "creationDate": "2025-12-17T18:03:05.037Z",
      "lastModifiedBy": "text",
      "createdBy": "text",
      "lastModifiedDate": "2025-12-17T18:03:05.037Z",
      "id": "text",
      "keepLastValues": true,
      "unit": "text",
      "engZeroScale": 1,
      "fractionalDigitCount": 1,
      "name": "text",
      "logExpressionId": "text",
      "logType": "No Log",
      "logExpressionCode": "text",
      "valueExpressionCode": "text",
      "valueExpressionId": "text",
      "isPulseOff": true,
      "frameId": "text",
      "setMinValue": 1,
      "pulseOffDuration": 1,
      "code": "text",
      "engFullScale": 1,
      "pulseOnDuration": 1,
      "logThreshold": 1,
      "rawFullScale": 1,
      "isPulseOn": true,
      "valueExpressionType": "NONE",
      "logMaxValue": 1,
      "setMaxValue": 1,
      "logMinValue": 1,
      "isActive": true,
      "projectId": "text",
      "rawZeroScale": 1,
      "logPeriod": 1,
      "dsc": "text",
      "bitOffset": 1,
      "maxLen": 1,
      "startAddress": 1,
      "type": "BIT",
      "connectionId": "text",
      "deviceId": "text"
    }
  ],
  "number": 1,
  "sort": [
    {
      "direction": "text",
      "nullHandling": "text",
      "ascending": true,
      "property": "text",
      "ignoreCase": true
    }
  ],
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "sort": [
      {
        "direction": "text",
        "nullHandling": "text",
        "ascending": true,
        "property": "text",
        "ignoreCase": true
      }
    ],
    "pageNumber": 1,
    "unpaged": true,
    "paged": true,
    "pageSize": 1
  },
  "empty": true
}

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

projectIdstringRequired

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables/by-project

GET /api/protocols/s7/variables/by-project?projectId=text HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

[
  {
    "creationDate": "2025-12-17T18:03:05.037Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-12-17T18:03:05.037Z",
    "id": "text",
    "keepLastValues": true,
    "unit": "text",
    "engZeroScale": 1,
    "fractionalDigitCount": 1,
    "name": "text",
    "logExpressionId": "text",
    "logType": "No Log",
    "logExpressionCode": "text",
    "valueExpressionCode": "text",
    "valueExpressionId": "text",
    "isPulseOff": true,
    "frameId": "text",
    "setMinValue": 1,
    "pulseOffDuration": 1,
    "code": "text",
    "engFullScale": 1,
    "pulseOnDuration": 1,
    "logThreshold": 1,
    "rawFullScale": 1,
    "isPulseOn": true,
    "valueExpressionType": "NONE",
    "logMaxValue": 1,
    "setMaxValue": 1,
    "logMinValue": 1,
    "isActive": true,
    "projectId": "text",
    "rawZeroScale": 1,
    "logPeriod": 1,
    "dsc": "text",
    "bitOffset": 1,
    "maxLen": 1,
    "startAddress": 1,
    "type": "BIT",
    "connectionId": "text",
    "deviceId": "text"
  }
]

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

projectIdstringRequired

namestringRequired

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables/by-project-and-name

GET /api/protocols/s7/variables/by-project-and-name?projectId=text&name=text HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

{
  "creationDate": "2025-12-17T18:03:05.037Z",
  "lastModifiedBy": "text",
  "createdBy": "text",
  "lastModifiedDate": "2025-12-17T18:03:05.037Z",
  "id": "text",
  "keepLastValues": true,
  "unit": "text",
  "engZeroScale": 1,
  "fractionalDigitCount": 1,
  "name": "text",
  "logExpressionId": "text",
  "logType": "No Log",
  "logExpressionCode": "text",
  "valueExpressionCode": "text",
  "valueExpressionId": "text",
  "isPulseOff": true,
  "frameId": "text",
  "setMinValue": 1,
  "pulseOffDuration": 1,
  "code": "text",
  "engFullScale": 1,
  "pulseOnDuration": 1,
  "logThreshold": 1,
  "rawFullScale": 1,
  "isPulseOn": true,
  "valueExpressionType": "NONE",
  "logMaxValue": 1,
  "setMaxValue": 1,
  "logMinValue": 1,
  "isActive": true,
  "projectId": "text",
  "rawZeroScale": 1,
  "logPeriod": 1,
  "dsc": "text",
  "bitOffset": 1,
  "maxLen": 1,
  "startAddress": 1,
  "type": "BIT",
  "connectionId": "text",
  "deviceId": "text"
}

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

variableIdsstring[]Required

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables/by-ids

GET /api/protocols/s7/variables/by-ids?variableIds=text HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

[
  {
    "creationDate": "2025-12-17T18:03:05.037Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-12-17T18:03:05.037Z",
    "id": "text",
    "keepLastValues": true,
    "unit": "text",
    "engZeroScale": 1,
    "fractionalDigitCount": 1,
    "name": "text",
    "logExpressionId": "text",
    "logType": "No Log",
    "logExpressionCode": "text",
    "valueExpressionCode": "text",
    "valueExpressionId": "text",
    "isPulseOff": true,
    "frameId": "text",
    "setMinValue": 1,
    "pulseOffDuration": 1,
    "code": "text",
    "engFullScale": 1,
    "pulseOnDuration": 1,
    "logThreshold": 1,
    "rawFullScale": 1,
    "isPulseOn": true,
    "valueExpressionType": "NONE",
    "logMaxValue": 1,
    "setMaxValue": 1,
    "logMinValue": 1,
    "isActive": true,
    "projectId": "text",
    "rawZeroScale": 1,
    "logPeriod": 1,
    "dsc": "text",
    "bitOffset": 1,
    "maxLen": 1,
    "startAddress": 1,
    "type": "BIT",
    "connectionId": "text",
    "deviceId": "text"
  }
]

get

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

frameIdstringRequired

Responses

200

OK

*/*

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get

/api/protocols/s7/variables/by-frame

GET /api/protocols/s7/variables/by-frame?frameId=text HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

[
  {
    "creationDate": "2025-12-17T18:03:05.037Z",
    "lastModifiedBy": "text",
    "createdBy": "text",
    "lastModifiedDate": "2025-12-17T18:03:05.037Z",
    "id": "text",
    "keepLastValues": true,
    "unit": "text",
    "engZeroScale": 1,
    "fractionalDigitCount": 1,
    "name": "text",
    "logExpressionId": "text",
    "logType": "No Log",
    "logExpressionCode": "text",
    "valueExpressionCode": "text",
    "valueExpressionId": "text",
    "isPulseOff": true,
    "frameId": "text",
    "setMinValue": 1,
    "pulseOffDuration": 1,
    "code": "text",
    "engFullScale": 1,
    "pulseOnDuration": 1,
    "logThreshold": 1,
    "rawFullScale": 1,
    "isPulseOn": true,
    "valueExpressionType": "NONE",
    "logMaxValue": 1,
    "setMaxValue": 1,
    "logMinValue": 1,
    "isActive": true,
    "projectId": "text",
    "rawZeroScale": 1,
    "logPeriod": 1,
    "dsc": "text",
    "bitOffset": 1,
    "maxLen": 1,
    "startAddress": 1,
    "type": "BIT",
    "connectionId": "text",
    "deviceId": "text"
  }
]

delete

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Query parameters

variableIdsstring[]Required

Responses

204

No Content

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

delete

/api/protocols/s7/variables/multi/by-ids

DELETE /api/protocols/s7/variables/multi/by-ids?variableIds=text HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Accept: */*

No content

delete

Authorizations

ins_access_tokenstringRequired

Access token provided as a cookie named 'ins_access_token'. This token is obtained after successful login and is valid for x minutes. It can be refreshed using the ins_refresh_token cookie at the /refresh endpoint.

X-SpacestringRequired

Required active space header

Body

namestringOptional

typestringOptional

dscInstringOptional

projectIdstringRequired

frameIdstringOptional

connectionIdstringOptional

nameInstringOptional

deviceIdstringOptional

Responses

204

No Content

400

Bad Request

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

delete

/api/protocols/s7/variables/filter

DELETE /api/protocols/s7/variables/filter HTTP/1.1
Host: inscada.cloud
X-Space: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "name": "text",
  "type": "text",
  "dscIn": "text",
  "projectId": "text",
  "frameId": "text",
  "connectionId": "text",
  "nameIn": "text",
  "deviceId": "text"
}

No content