> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/integrations/overview/energy-data/manual-upload.md).

# Manual upload

Most energy data flows into Myrspoven automatically — from a BMS, from a third-party energy provider, or directly from meters. When automated data transfer isn't possible, you can upload energy data manually instead.

## When to use manual upload

Common reasons to upload manually:

* You don't have a way to share energy data through an automated channel.
* You use a third-party energy provider that Myrspoven doesn't currently integrate with. See [Requesting a new third-party integration](/integrations/overview/energy-data.md#requesting-a-new-third-party-integration) if you'd like us to support a new provider.
* Historical data has been corrected or rescaled — for example, units changed from megawatts (MW) to kilowatts (kW). Previously uploaded data will appear in different numerical values in this case (1 MW = 1000 kW).
* A time period contains missing data that needs to be backfilled.

## How uploaded data is handled

Data you upload is treated as the **most accurate and up-to-date source** for that signal.

If you upload data for a time period that already has data in the system, the existing values within that period are automatically replaced by the new upload. The system will always reflect the latest reliable data you've provided — there's no manual merge step. If you have two separate intervals of data that need to be updated, you must upload the data in two separate batches to avoid losing the data in between.

## Supported data format

The minimum structure for an upload is two columns:

1. **Timestamp**
2. **Energy value**

The system automatically converts units when the uploaded units differ from those stored for the signal — for example, an upload in kWh against a signal stored in MWh. If a conversion isn't possible (for example, mismatched dimensions), you'll be notified during the upload process and the upload will be rejected.

{% hint style="info" %}
The in-app instructions are canonical. The upload form in BackOffice includes step-by-step guidance on the exact file format and field requirements. If anything on this page differs from what the upload form shows, follow the form — it's always the most up to date.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.myrspoven.com/integrations/overview/energy-data/manual-upload.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.