How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Powernaut sites API

Register, modify or delete sites.Sites are the start of everything, they are required to uniquely identify the end consumer's connection to the grid. They define the meter point(s) for which flexibility is activated.⚠️ The `/v1/connect/connection-points` endpoints have moved to `/v1/connect/sites`. The original paths have been deprecated.

Powernaut sites API is one of 14 APIs that Powernaut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Sites. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 12 operations across 7 paths, and defines 22 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.sandbox.powernaut.io, https://api.powernaut.io.

12 operations 7 paths 22 schemas 2 DELETE3 GET1 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.powernaut.io
Authentication
HTTP Bearer, HTTP Basic, HTTP Basic
Resource Areas
1

Authentication & Security 3

Powernaut sites API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (cloud-cloud). It accepts HTTP basic authentication (token). It accepts HTTP basic authentication (edge-cloud).

  • cloud-cloud — A bearer token obtained from the token endpoint.
  • token — Your client id and secret to obtain a bearer token for cloud-cloud authentication.
  • edge-cloud — Basic credentials used for edge-cloud authentication. They can be obtained when creating a site.

Paths & Operations 12

Across 7 paths, the API surfaces 12 operations — 2 DELETE, 3 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

sites 12

Register, modify or delete sites. Sites are the start of everything, they are required to uniquely identify the end consumer's connection to the grid. They define the meter point(…

POST
/v1/connect/sites
Create a site
CreateSite body → 201400401403
GET
/v1/connect/sites
Get all sites
FindAllSites 2 params → 200400401403
GET
/v1/connect/sites/{id}
Get a site
GetSite 1 param → 200400401403404
PATCH
/v1/connect/sites/{id}
Update a site
UpdateSite 1 param body → 202400401403404
DELETE
/v1/connect/sites/{id}
Delete a site
RemoveSite 1 param → 204400401403404
POST
/v1/connect/sites/{id}/credentials
Generate connection credentials
SitesController_createCredentials_v1 1 param body → 201400401403404409
GET
/v1/connect/sites/{id}/credentials
List credential metadata
SitesController_listCredentials_v1 1 param → 200400401403404
DELETE
/v1/connect/sites/{id}/credentials
Revoke credentials
SitesController_revokeCredentials_v1 2 params → 204400401403404
POST
/v1/connect/sites/{id}/credentials/rotate
Rotate credentials
SitesController_startRotation_v1 2 params → 200400401403
POST
/v1/connect/sites/{id}/credentials/rotate/complete
Complete credential rotation
SitesController_completeRotation_v1 2 params → 204400401403
POST
/v1/connect/sites/{id}/credentials/rotate/cancel
Cancel credential rotation
SitesController_cancelRotation_v1 2 params → 204400401403
POST
/v1/connect/historical-data/{import_id}/confirm
Confirm a historical data import
ConfirmHistoricalDataImport 1 param → 200400401403404409

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are ConnectionPointWithCredentialsDto (13 properties), ConnectionPointDto (12 properties), UpdateConnectionPointDto (6 properties), CreateConnectionPointDto (5 properties). Each schema is shown below with its type and property counts.

CreateConnectionPointDto
object
5 properties 2 required
ForbiddenDto_SW1wb3J0IGRvZXMgbm90IGJlbG9uZyB0byB0aGUgYXV0aGVudGljYXRlZCB1c2Vy
object
3 properties 3 required
ConflictDto_QSBjcmVkZW50aWFsIHNldCB3aXRoIHRoaXMgbmFtZSBhbHJlYWR5IGV4aXN0cyBmb3IgdGhpcyBjb25uZWN0aW9uIHBvaW50
object
3 properties 3 required
ConnectionPointCredentialDto
object
3 properties 3 required
ForbiddenExceptionDto
object
3 properties 3 required
ConnectionPointWithCredentialsDto
object
13 properties 11 required
NotFoundDto_SGlzdG9yaWNhbCBkYXRhIGltcG9ydCBub3QgZm91bmQ
object
3 properties 3 required
UnauthorizedExceptionDto
object
3 properties 3 required
ConnectionPointDto
object
12 properties 10 required
ConnectionPointListDto
object
2 properties 2 required
ConflictDto_SW1wb3J0IGlzIG5vdCBpbiBwZW5kaW5nIHN0YXR1cw
object
3 properties 3 required
UpdateConnectionPointDto
object
6 properties
CreateConnectionPointCredentialDto
object
1 property 1 required
CreateSupplyPointDto
object
2 properties 1 required
BadRequestExceptionDto
object
3 properties 3 required
ConnectionPointStoredCredentialDto
object
3 properties 3 required
AddressLocationDto
object
1 property 1 required
ConnectionPointStoredCredentialListDto
object
1 property 1 required
SupplyPointDto
object
2 properties 2 required
ConfirmImportResponseDto
object
1 property 1 required
NotFoundDto_U2l0ZSBkb2VzIG5vdCBleGlzdA
object
3 properties 3 required
GeoLocationDto
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

powernaut-sites-api-openapi.yml Raw ↑

Other APIs Powernaut publishes across the network.

Powernaut authentication API
Powernaut baselining API
Powernaut creating_bids API
Powernaut events API
Powernaut getting_forecasts API
Powernaut historical_data API
Powernaut managing_bids API
Powernaut markets API
Powernaut metrics API
Powernaut resources API
Powernaut sensor_data API
Powernaut uploading_forecasts API
Where this information came from

This is an independent, third-party profile of Powernaut sites API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.