Portfolios

List the available portfolios

get

List the available portfolios

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Responses

200

successful operation

application/json

400

Invalid status value

application/json

get

/portfolios

HTTPcURLJavaScriptPython

GET /portfolios HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{
  "portfolios": [
    null,
    null
  ]
}

Create a new Portfolio

post

Create a new Portfolio and generate a unique ID

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Body

application/json

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

namestringRequired

projectsstring[] · min: 1Required

Responses

200

successful operation

application/json

400

Invalid status value

application/json

post

/portfolios

HTTPcURLJavaScriptPython

POST /portfolios HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "name": "text",
  "projects": [
    "text"
  ],
  "reports": {
    "operating": true
  }
}

{
  "portfolio": {
    "name": "text",
    "projects": [
      "text"
    ],
    "reports": {
      "operating": true
    }
  }
}

Get Portfolio details

get

Gets the details for the specified Portfolio

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

portfolioIdstringRequired

The Portfolio ID

Responses

200

successful operation

application/json

400

Invalid status value

application/json

get

/portfolios/{portfolioId}

HTTPcURLJavaScriptPython

GET /portfolios/{portfolioId} HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{
  "portfolio": {
    "name": "text",
    "projects": [
      "text"
    ],
    "reports": {
      "operating": true
    }
  }
}

Update an existing Portfolio

put

Update an existing Portfolio

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

portfolioIdstringRequired

The Portfolio ID

Body

application/json

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

namestringRequired

projectsstring[] · min: 1Required

Responses

200

successful operation

application/json

400

Invalid status value

application/json

put

/portfolios/{portfolioId}

HTTPcURLJavaScriptPython

PUT /portfolios/{portfolioId} HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "name": "text",
  "projects": [
    "text"
  ],
  "reports": {
    "operating": true
  }
}

{
  "portfolio": {
    "name": "text",
    "projects": [
      "text"
    ],
    "reports": {
      "operating": true
    }
  }
}

Deletes an existing Portfolio

delete

Deletes an existing Portfolio

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

portfolioIdstringRequired

The Portfolio ID

Responses

200

successful operation

application/json

Responseobject

400

Invalid status value

application/json

delete

/portfolios/{portfolioId}

HTTPcURLJavaScriptPython

DELETE /portfolios/{portfolioId} HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{}