API Documentation
  • API Documentation
  • Ecosuite Project Data API
    • Authentication
    • OpenAPI reference
      • Events
        • Resolve
      • Feedback
      • Profile
      • Portfolios
      • Projects
        • Contacts
        • Pro forma
          • Versions
        • I2x
        • Records
        • Sites
          • Records
          • Systems
            • Records
        • Record documents
      • Record documents
      • Records
        • Record documents
      • Service requests
        • Generate
        • Resolve
      • Tariff
      • User groups
      • Users
        • Alerts
        • Groups
          • Reset
        • Mfa
        • Notifications
        • Resend
      • User types
      • Audit
        • Assets
        • Projects
        • Users
      • Coda
        • Milestones
        • Import
      • Connectivity
        • Data
        • Devices
      • Dashboard
        • Status
      • Energy
        • Datums
          • Most recent
          • Projects
          • Consumption
            • Cost
              • Projects
            • Predicted
              • Projects
            • Projects
          • Cumulative
            • Projects
          • Generation
            • Expected
            • Predicted
              • Projects
          • Nodes
            • Projects
        • Export
        • Instantaneous
        • Readings
        • Status
      • Finance
        • Cashflow totals
        • Report
        • Transactions
        • Sources uses
          • Sources uses
        • Export
          • Report
        • Projects
          • Billing
          • CashFlowTimeSeriesArrears
          • Categories
          • Irr categories
          • Report
          • Settings
          • Sources uses
          • Import
          • Cash flows
            • Payment logs
          • Pro forma
            • Irr
        • Record
          • Payments
        • Softledger
          • Locations
      • Media
        • Files
        • Tags
          • Storage
            • Code
            • Labels
          • Default
        • Storage
          • File
          • Code
      • Public
        • Projects
        • Energy
          • Datums
            • Projects
          • Readings
            • Projects
      • Schemas
        • Rfi
        • RfiReply
        • Dr event
        • Dr notification
        • Event
        • Participant
        • Finance
        • Notification
        • Portfolio
        • Pro forma
        • Profile
        • Project
        • Record
        • Service request
        • Site
        • System
        • User
        • User type
        • User groups
        • New tariff
        • Tariff
      • Rfi
        • Thread
          • Code
          • Resolve
          • Version
          • Replies
        • Reply
          • Version
      • Search
        • Refinements
      • Solarnetwork
        • Devices
        • Instruction
        • Nodes
        • Ssh
        • Credentials
          • Solarflux
          • Solarnode
          • Ssh
        • Metadata
          • Projects
        • Settings
          • Node ids
        • Solarnode
          • Login url
      • Tools
        • Address business details
      • Dr
        • Participants
        • Dr events
        • Dr notifications
      • Report
        • Operating
          • Project
      • Weather
        • Datums
          • Projects
        • Daylight
          • Projects
            • Sites
        • Projects
          • Sites
    • OpenAPI Specification
  • Ecosuite Time Series Data API
Powered by GitBook
On this page
  1. Ecosuite Project Data API
  2. OpenAPI reference
  3. Projects
  4. Sites

Systems

PreviousRecordsNextRecords

Deletes an existing system

delete

Deletes an existing system

Authorizations
Path parameters
projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

systemIdstringRequired

The system ID

Responses
200
successful operation
application/json
Responseobject
400
Invalid status value
application/json
delete
DELETE //projects/{projectId}/sites/{siteId}/systems/{systemId} HTTP/1.1
Host: api.ecosuite.io
Authorization: YOUR_API_KEY
Accept: */*
{}
  • POSTCreate a new system
  • PUTUpdate an existing system
  • DELETEDeletes an existing system

Create a new system

post

Create a new system with the specified ID

Authorizations
Path parameters
projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

systemIdstringRequired

The system ID

Body

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
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": "2025-06-16",
  "type": "generation",
  "meterNumber": "text",
  "contractedDemand": 1,
  "verified": false
}
{
  "site": {
    "code": "text",
    "status": "New System",
    "name": "text",
    "startDate": "2025-06-16",
    "type": "generation",
    "meterNumber": "text",
    "contractedDemand": 1,
    "verified": false
  }
}

Update an existing system

put

Update an existing system

Authorizations
Path parameters
projectIdstringRequired

The project ID

siteIdstringRequired

The site ID

systemIdstringRequired

The system ID

Body

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
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": "2025-06-16",
  "type": "generation",
  "meterNumber": "text",
  "contractedDemand": 1,
  "verified": false
}
{
  "system": {
    "code": "text",
    "status": "New System",
    "name": "text",
    "startDate": "2025-06-16",
    "type": "generation",
    "meterNumber": "text",
    "contractedDemand": 1,
    "verified": false
  }
}