Systems

Create a new system

post

Create a new system with the specified ID

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

systemIdstringRequired

The system ID

Body

application/json

Refer to the /schemas/system endpoint for the full JSON Schema definition

codestringRequiredPattern: ^[A-Z0-9]*$

statusstring · enumRequiredDefault: New SystemPossible values:

namestringRequired

startDatestring · dateRequired

typestring · enumRequiredPossible values:

meterNumberstringOptional

contractedDemandnumberOptional

verifiedbooleanOptionalDefault: false

Responses

200

successful operation

application/json

400

Invalid status value

application/json

post

/projects/{projectId}/sites/{siteId}/systems/{systemId}

HTTPcURLJavaScriptPython

POST /projects/{projectId}/sites/{siteId}/systems/{systemId} HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "code": "text",
  "status": "New System",
  "name": "text",
  "startDate": "2026-03-23",
  "type": "generation",
  "meterNumber": "text",
  "contractedDemand": 1,
  "verified": false
}

{
  "site": {
    "code": "text",
    "status": "New System",
    "name": "text",
    "startDate": "2026-03-23",
    "type": "generation",
    "meterNumber": "text",
    "contractedDemand": 1,
    "verified": false
  }
}

Update an existing system

put

Update an existing system

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

systemIdstringRequired

The system ID

Body

application/json

Refer to the /schemas/system endpoint for the full JSON Schema definition

codestringRequiredPattern: ^[A-Z0-9]*$

statusstring · enumRequiredDefault: New SystemPossible values:

namestringRequired

startDatestring · dateRequired

typestring · enumRequiredPossible values:

meterNumberstringOptional

contractedDemandnumberOptional

verifiedbooleanOptionalDefault: false

Responses

200

successful operation

application/json

400

Invalid status value

application/json

put

/projects/{projectId}/sites/{siteId}/systems/{systemId}

HTTPcURLJavaScriptPython

PUT /projects/{projectId}/sites/{siteId}/systems/{systemId} HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "code": "text",
  "status": "New System",
  "name": "text",
  "startDate": "2026-03-23",
  "type": "generation",
  "meterNumber": "text",
  "contractedDemand": 1,
  "verified": false
}

{
  "system": {
    "code": "text",
    "status": "New System",
    "name": "text",
    "startDate": "2026-03-23",
    "type": "generation",
    "meterNumber": "text",
    "contractedDemand": 1,
    "verified": false
  }
}

Deletes an existing system

delete

Deletes an existing system

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

systemIdstringRequired

The system ID

Responses

200

successful operation

application/json

objectOptional

400

Invalid status value

application/json

delete

/projects/{projectId}/sites/{siteId}/systems/{systemId}

HTTPcURLJavaScriptPython

DELETE /projects/{projectId}/sites/{siteId}/systems/{systemId} HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{}