Skip to main content

Asset Provisioning and Lifecycle

Overview​

Battery and solar assets in the Covolt ecosystem represent physical devices that can be monitored and controlled through our API. This guide explains how assets are provisioned and made available for your use.

Asset Provisioning Process​

Covolt handles the entire asset provisioning process for you. When your physical battery or solar installation is set up and connected to our system, we automatically:

  1. Create the digital asset representation in our system
  2. Assign a unique asset_id to your device
  3. Configure the necessary communication channels
  4. Validate the connection and data flow
  5. Make the asset available through the API
info

As soon as your assets are created in our system, they become immediately available for monitoring and control through the API.

Discovering Your Assets​

To find all assets that have been provisioned for your account, use the list endpoints:

For Battery Assets:​

GET /v2/battery-assets/

For Solar Assets:​

GET /v2/solar-assets/

These endpoints return paginated lists of all assets you have access to, including their unique identifiers.

Asset Information​

Once you know your asset's ID, you can retrieve detailed information about a specific asset:

For a Battery Asset:​

GET /v2/battery-assets/{asset_id}/

For a Solar Asset:​

GET /v2/solar-assets/{asset_id}/

Asset Lifecycle​

Assets in the Covolt system follow this general lifecycle:

  1. Provisioning: Asset is created and made available in the API
  2. Active: Asset is online and can be monitored and controlled
  3. Temporarily Offline: Asset may occasionally lose connection but will reconnect automatically
  4. Decommissioned: Asset is permanently removed from the system (rare)

At any point during the active phase, you can:

  • Monitor the asset's telemetry data
  • Send control instructions
  • Configure grid constraints (for battery assets)

Best Practices​

  • Regular Polling: Check your assets' status regularly to ensure they're online and functioning properly
  • Asset Verification: After you're notified that a new asset has been provisioned, verify it's available and reporting telemetry data
  • Multiple Asset Management: Use the filtering capabilities of the list endpoints when managing many assets