Update silo
curl --request PUT \
--url https://api.emidat.com/v2/silos/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "CEMENT_SILO_MUNICH_1",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Cement Silo 1 (Munich, renamed)",
"items": [
{
"supplier_product_id": "33333333-3333-3333-3333-333333333333",
"annual_items": [
{
"year": 2024,
"amount": 600000
},
{
"year": 2025,
"amount": 700000
}
]
},
{
"supplier_product_id": "44444444-4444-4444-4444-444444444444",
"annual_items": [
{
"year": 2024,
"amount": 400000
}
]
}
]
}
'import requests
url = "https://api.emidat.com/v2/silos/{id}"
payload = {
"external_id": "CEMENT_SILO_MUNICH_1",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Cement Silo 1 (Munich, renamed)",
"items": [
{
"supplier_product_id": "33333333-3333-3333-3333-333333333333",
"annual_items": [
{
"year": 2024,
"amount": 600000
},
{
"year": 2025,
"amount": 700000
}
]
},
{
"supplier_product_id": "44444444-4444-4444-4444-444444444444",
"annual_items": [
{
"year": 2024,
"amount": 400000
}
]
}
]
}
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: 'CEMENT_SILO_MUNICH_1',
plant_id: '11111111-1111-1111-1111-111111111111',
name: 'Cement Silo 1 (Munich, renamed)',
items: [
{
supplier_product_id: '33333333-3333-3333-3333-333333333333',
annual_items: [{year: 2024, amount: 600000}, {year: 2025, amount: 700000}]
},
{
supplier_product_id: '44444444-4444-4444-4444-444444444444',
annual_items: [{year: 2024, amount: 400000}]
}
]
})
};
fetch('https://api.emidat.com/v2/silos/{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/silos/{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' => 'CEMENT_SILO_MUNICH_1',
'plant_id' => '11111111-1111-1111-1111-111111111111',
'name' => 'Cement Silo 1 (Munich, renamed)',
'items' => [
[
'supplier_product_id' => '33333333-3333-3333-3333-333333333333',
'annual_items' => [
[
'year' => 2024,
'amount' => 600000
],
[
'year' => 2025,
'amount' => 700000
]
]
],
[
'supplier_product_id' => '44444444-4444-4444-4444-444444444444',
'annual_items' => [
[
'year' => 2024,
'amount' => 400000
]
]
]
]
]),
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/silos/{id}"
payload := strings.NewReader("{\n \"external_id\": \"CEMENT_SILO_MUNICH_1\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Cement Silo 1 (Munich, renamed)\",\n \"items\": [\n {\n \"supplier_product_id\": \"33333333-3333-3333-3333-333333333333\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 600000\n },\n {\n \"year\": 2025,\n \"amount\": 700000\n }\n ]\n },\n {\n \"supplier_product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 400000\n }\n ]\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/silos/{id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"CEMENT_SILO_MUNICH_1\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Cement Silo 1 (Munich, renamed)\",\n \"items\": [\n {\n \"supplier_product_id\": \"33333333-3333-3333-3333-333333333333\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 600000\n },\n {\n \"year\": 2025,\n \"amount\": 700000\n }\n ]\n },\n {\n \"supplier_product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 400000\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/silos/{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\": \"CEMENT_SILO_MUNICH_1\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Cement Silo 1 (Munich, renamed)\",\n \"items\": [\n {\n \"supplier_product_id\": \"33333333-3333-3333-3333-333333333333\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 600000\n },\n {\n \"year\": 2025,\n \"amount\": 700000\n }\n ]\n },\n {\n \"supplier_product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 400000\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "CEMENT_SILO_MUNICH_1",
"plant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Cement Silo 1 (Munich)",
"items": [
{
"supplier_product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"annual_items": [
{
"year": 2024,
"amount": 5000
}
]
}
],
"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
}Silos
Update silo
Full replacement of editable fields. Immutable plant_id may be omitted
or echoed from the current resource. external_id is
replaced: re-sending this silo’s own code succeeds unchanged, while a code
held by another active silo returns 409. See External IDs.
PUT
/
v2
/
silos
/
{id}
Update silo
curl --request PUT \
--url https://api.emidat.com/v2/silos/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "CEMENT_SILO_MUNICH_1",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Cement Silo 1 (Munich, renamed)",
"items": [
{
"supplier_product_id": "33333333-3333-3333-3333-333333333333",
"annual_items": [
{
"year": 2024,
"amount": 600000
},
{
"year": 2025,
"amount": 700000
}
]
},
{
"supplier_product_id": "44444444-4444-4444-4444-444444444444",
"annual_items": [
{
"year": 2024,
"amount": 400000
}
]
}
]
}
'import requests
url = "https://api.emidat.com/v2/silos/{id}"
payload = {
"external_id": "CEMENT_SILO_MUNICH_1",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Cement Silo 1 (Munich, renamed)",
"items": [
{
"supplier_product_id": "33333333-3333-3333-3333-333333333333",
"annual_items": [
{
"year": 2024,
"amount": 600000
},
{
"year": 2025,
"amount": 700000
}
]
},
{
"supplier_product_id": "44444444-4444-4444-4444-444444444444",
"annual_items": [
{
"year": 2024,
"amount": 400000
}
]
}
]
}
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: 'CEMENT_SILO_MUNICH_1',
plant_id: '11111111-1111-1111-1111-111111111111',
name: 'Cement Silo 1 (Munich, renamed)',
items: [
{
supplier_product_id: '33333333-3333-3333-3333-333333333333',
annual_items: [{year: 2024, amount: 600000}, {year: 2025, amount: 700000}]
},
{
supplier_product_id: '44444444-4444-4444-4444-444444444444',
annual_items: [{year: 2024, amount: 400000}]
}
]
})
};
fetch('https://api.emidat.com/v2/silos/{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/silos/{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' => 'CEMENT_SILO_MUNICH_1',
'plant_id' => '11111111-1111-1111-1111-111111111111',
'name' => 'Cement Silo 1 (Munich, renamed)',
'items' => [
[
'supplier_product_id' => '33333333-3333-3333-3333-333333333333',
'annual_items' => [
[
'year' => 2024,
'amount' => 600000
],
[
'year' => 2025,
'amount' => 700000
]
]
],
[
'supplier_product_id' => '44444444-4444-4444-4444-444444444444',
'annual_items' => [
[
'year' => 2024,
'amount' => 400000
]
]
]
]
]),
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/silos/{id}"
payload := strings.NewReader("{\n \"external_id\": \"CEMENT_SILO_MUNICH_1\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Cement Silo 1 (Munich, renamed)\",\n \"items\": [\n {\n \"supplier_product_id\": \"33333333-3333-3333-3333-333333333333\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 600000\n },\n {\n \"year\": 2025,\n \"amount\": 700000\n }\n ]\n },\n {\n \"supplier_product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 400000\n }\n ]\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/silos/{id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"CEMENT_SILO_MUNICH_1\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Cement Silo 1 (Munich, renamed)\",\n \"items\": [\n {\n \"supplier_product_id\": \"33333333-3333-3333-3333-333333333333\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 600000\n },\n {\n \"year\": 2025,\n \"amount\": 700000\n }\n ]\n },\n {\n \"supplier_product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 400000\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/silos/{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\": \"CEMENT_SILO_MUNICH_1\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Cement Silo 1 (Munich, renamed)\",\n \"items\": [\n {\n \"supplier_product_id\": \"33333333-3333-3333-3333-333333333333\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 600000\n },\n {\n \"year\": 2025,\n \"amount\": 700000\n }\n ]\n },\n {\n \"supplier_product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"annual_items\": [\n {\n \"year\": 2024,\n \"amount\": 400000\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "CEMENT_SILO_MUNICH_1",
"plant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Cement Silo 1 (Munich)",
"items": [
{
"supplier_product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"annual_items": [
{
"year": 2024,
"amount": 5000
}
]
}
],
"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
}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
The silo's Emidat UUID.
Body
application/json
Full replacement of editable fields. Every editable field is required and overwrites the stored value. The immutable plant may be omitted or echoed from the current resource.
Your own silo code. Overwrites the stored code; pass null to clear it.
Must stay unique among your active silos — a code held by another returns
409 (see External IDs).
Example:
"CEMENT_SILO_MUNICH_1"
Updated silo name.
Replaces the full items list — at least 1 item.
Minimum array length:
1One supplier product contributing to a silo, with the volumes purchased from that supplier per calendar year. All items in a silo share the same material type — the same elementary, or the same composite; the unit is derived from it. Missing annual quantities block calculation; enter an explicit zero when this supplier contributes nothing that year.
- Option 1
- Option 2
Show child attributes
Show child attributes
Optional assertion of the resource ID. It must match the path id.
Optional assertion of the current plant. A different value returns
422.
Response
Updated silo.
A silo has the same ingredients across all years, with quantities entered per year. Calculation requires an explicit amount for every ingredient in the selected year and a positive total. Missing quantities are incomplete; zero means no contribution. These rules apply to both supplier and prechain ingredients. Existing supplier-only compositions retain their historical shares through a one-time backfill of implicit zeros.
Emidat-assigned silo UUID.
Your own code for this silo, null when none is set. BOM entries reference it by its Emidat id, not this code.
Example:
"CEMENT_SILO_MUNICH_1"
The plant's Emidat UUID.
Human-readable silo name.
Example:
"Cement Silo 1 (Munich)"
Supplier products and prechain products constituting this silo, with annual quantities.
One supplier product contributing to a silo, with the volumes purchased from that supplier per calendar year. All items in a silo share the same material type — the same elementary, or the same composite; the unit is derived from it. Missing annual quantities block calculation; enter an explicit zero when this supplier contributes nothing that year.
- Option 1
- Option 2
Show child attributes
Show child attributes
⌘I