Update project
curl --request PUT \
--url https://api.emidat.com/v2/projects/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "PRJ-2026-014",
"name": "Tower A — phase 2",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 180
}
]
}
'import requests
url = "https://api.emidat.com/v2/projects/{id}"
payload = {
"external_id": "PRJ-2026-014",
"name": "Tower A — phase 2",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 180
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'PRJ-2026-014',
name: 'Tower A — phase 2',
customer_name: 'Bauherr GmbH',
address: {
country: 'DE',
city: 'Munich',
latitude: 48.1351,
longitude: 11.575,
street: 'Musterstraße',
house_number: '12',
postal_code: '80331',
state: 'Bavaria',
formatted_address: 'Musterstraße 12, 80331 Munich, Germany'
},
products: [{product_id: '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b', quantity: 180}]
})
};
fetch('https://api.emidat.com/v2/projects/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.emidat.com/v2/projects/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'PRJ-2026-014',
'name' => 'Tower A — phase 2',
'customer_name' => 'Bauherr GmbH',
'address' => [
'country' => 'DE',
'city' => 'Munich',
'latitude' => 48.1351,
'longitude' => 11.575,
'street' => 'Musterstraße',
'house_number' => '12',
'postal_code' => '80331',
'state' => 'Bavaria',
'formatted_address' => 'Musterstraße 12, 80331 Munich, Germany'
],
'products' => [
[
'product_id' => '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b',
'quantity' => 180
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.emidat.com/v2/projects/{id}"
payload := strings.NewReader("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A — phase 2\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 180\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.emidat.com/v2/projects/{id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A — phase 2\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 180\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/projects/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A — phase 2\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 180\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"name": "Tower A",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bauherr GmbH"
},
"address": {
"country": "DE",
"city": "Munich",
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, DE"
},
"products": [
{
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 120,
"gwp_per_unit": 245.1,
"gwp_per_unit_net": 240.7
}
],
"gwp_total": 123,
"gwp_total_net": 123,
"created_at": "2023-11-07T05:31:56Z"
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}Projects
Update project
Full replacement of editable fields, the product lines included.
external_id is replaced: re-sending this project’s own code succeeds
unchanged, while a code held by another active project returns 409.
See External IDs.
PUT
/
v2
/
projects
/
{id}
Update project
curl --request PUT \
--url https://api.emidat.com/v2/projects/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "PRJ-2026-014",
"name": "Tower A — phase 2",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 180
}
]
}
'import requests
url = "https://api.emidat.com/v2/projects/{id}"
payload = {
"external_id": "PRJ-2026-014",
"name": "Tower A — phase 2",
"customer_name": "Bauherr GmbH",
"address": {
"country": "DE",
"city": "Munich",
"latitude": 48.1351,
"longitude": 11.575,
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, Germany"
},
"products": [
{
"product_id": "8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
"quantity": 180
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'PRJ-2026-014',
name: 'Tower A — phase 2',
customer_name: 'Bauherr GmbH',
address: {
country: 'DE',
city: 'Munich',
latitude: 48.1351,
longitude: 11.575,
street: 'Musterstraße',
house_number: '12',
postal_code: '80331',
state: 'Bavaria',
formatted_address: 'Musterstraße 12, 80331 Munich, Germany'
},
products: [{product_id: '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b', quantity: 180}]
})
};
fetch('https://api.emidat.com/v2/projects/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.emidat.com/v2/projects/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'PRJ-2026-014',
'name' => 'Tower A — phase 2',
'customer_name' => 'Bauherr GmbH',
'address' => [
'country' => 'DE',
'city' => 'Munich',
'latitude' => 48.1351,
'longitude' => 11.575,
'street' => 'Musterstraße',
'house_number' => '12',
'postal_code' => '80331',
'state' => 'Bavaria',
'formatted_address' => 'Musterstraße 12, 80331 Munich, Germany'
],
'products' => [
[
'product_id' => '8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b',
'quantity' => 180
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.emidat.com/v2/projects/{id}"
payload := strings.NewReader("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A — phase 2\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 180\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.emidat.com/v2/projects/{id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A — phase 2\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 180\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/projects/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"PRJ-2026-014\",\n \"name\": \"Tower A — phase 2\",\n \"customer_name\": \"Bauherr GmbH\",\n \"address\": {\n \"country\": \"DE\",\n \"city\": \"Munich\",\n \"latitude\": 48.1351,\n \"longitude\": 11.575,\n \"street\": \"Musterstraße\",\n \"house_number\": \"12\",\n \"postal_code\": \"80331\",\n \"state\": \"Bavaria\",\n \"formatted_address\": \"Musterstraße 12, 80331 Munich, Germany\"\n },\n \"products\": [\n {\n \"product_id\": \"8f1e2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b\",\n \"quantity\": 180\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"name": "Tower A",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Bauherr GmbH"
},
"address": {
"country": "DE",
"city": "Munich",
"street": "Musterstraße",
"house_number": "12",
"postal_code": "80331",
"state": "Bavaria",
"formatted_address": "Musterstraße 12, 80331 Munich, DE"
},
"products": [
{
"product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 120,
"gwp_per_unit": 245.1,
"gwp_per_unit_net": 240.7
}
],
"gwp_total": 123,
"gwp_total_net": 123,
"created_at": "2023-11-07T05:31:56Z"
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}{
"msg": "supplier product requires a supplier plant",
"err_code": "err_supplier_product_missing_supplier_plant",
"entitlement_limit": {
"dimension": "users",
"usage": 123,
"limit": 123
},
"product_categories": [
"<string>"
],
"epd_category": 123
}Authorizations
Per-manufacturer API key in the X-API-Key header, format
emidat-{key_id}-{secret} where key_id is a random public handle.
Issued by an owner in the Emidat
dashboard; carries its own permission scopes, optional plant
restrictions, and optional expiry. A revoked, expired, or unknown key
returns 401. See the Authentication guide for details.
Path Parameters
UUID of the project to update.
Body
application/json
Full replacement of editable fields. Every editable field is required,
and products replaces the project's lines as a whole.
Your own code for this project. Overwrites the stored code; pass
null to clear it. Must stay unique among your active projects — a
code held by another returns 409 (see External IDs).
Example:
"PRJ-2026-014"
Surrounding spaces are ignored; an empty name returns 422.
Minimum string length:
1Example:
"Tower A"
Name of one of your customers, exactly as it is in the Emidat app
(surrounding spaces are ignored). Customers are not created through
the API: a name with no customer returns 422
(err_customer_not_found).
Minimum string length:
1Example:
"Bauherr GmbH"
The site address of a project, stored exactly as sent; a field you
leave out is stored empty. A new or changed address needs city, and
is located to place the site: no location found in country returns
422 (err_address_not_found), and a lookup that cannot be carried
out right now returns 503 (err_geocoding_unavailable). An address
identical to the stored one (ignoring surrounding spaces) is kept as
it is, without a lookup.
Show child attributes
Show child attributes
Minimum array length:
1Show child attributes
Show child attributes
Optional assertion of the resource ID. It must match the path id.
Response
Updated project.
UUID of the project.
Your own code for this project. null when none is set.
Example:
"Tower A"
The client a project is built for. Customers are managed in the Emidat
app; a project names its customer by customer_name.
Show child attributes
Show child attributes
The site address of a project, exactly as it was sent. Fields left
out are empty strings, except house_number, which is null.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
A1–A3 GWP-total (EN 15804+A2) of the whole delivery in kg CO₂e: the
sum over the lines of quantity times gwp_per_unit. null while
any line's gwp_per_unit is null; the lines show which.
As gwp_total, from the lines' gwp_per_unit_net. null while any
line's gwp_per_unit_net is null.
⌘I