Create composite
curl --request POST \
--url https://api.emidat.com/v2/composites \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "22222222-2222-2222-2222-222222222222",
"percentage": 60
},
{
"elementary_id": "55555555-5555-5555-5555-555555555555",
"percentage": 30
},
{
"elementary_id": "66666666-6666-6666-6666-666666666666",
"percentage": 10
}
]
}
'import requests
url = "https://api.emidat.com/v2/composites"
payload = {
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "22222222-2222-2222-2222-222222222222",
"percentage": 60
},
{
"elementary_id": "55555555-5555-5555-5555-555555555555",
"percentage": 30
},
{
"elementary_id": "66666666-6666-6666-6666-666666666666",
"percentage": 10
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'BLENDED_CEMENT_MIX_A',
plant_id: '11111111-1111-1111-1111-111111111111',
name: 'Blended Cement Mix A',
composite_type: 'chemicals',
items: [
{elementary_id: '22222222-2222-2222-2222-222222222222', percentage: 60},
{elementary_id: '55555555-5555-5555-5555-555555555555', percentage: 30},
{elementary_id: '66666666-6666-6666-6666-666666666666', percentage: 10}
]
})
};
fetch('https://api.emidat.com/v2/composites', 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/composites",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'BLENDED_CEMENT_MIX_A',
'plant_id' => '11111111-1111-1111-1111-111111111111',
'name' => 'Blended Cement Mix A',
'composite_type' => 'chemicals',
'items' => [
[
'elementary_id' => '22222222-2222-2222-2222-222222222222',
'percentage' => 60
],
[
'elementary_id' => '55555555-5555-5555-5555-555555555555',
'percentage' => 30
],
[
'elementary_id' => '66666666-6666-6666-6666-666666666666',
'percentage' => 10
]
]
]),
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/composites"
payload := strings.NewReader("{\n \"external_id\": \"BLENDED_CEMENT_MIX_A\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Blended Cement Mix A\",\n \"composite_type\": \"chemicals\",\n \"items\": [\n {\n \"elementary_id\": \"22222222-2222-2222-2222-222222222222\",\n \"percentage\": 60\n },\n {\n \"elementary_id\": \"55555555-5555-5555-5555-555555555555\",\n \"percentage\": 30\n },\n {\n \"elementary_id\": \"66666666-6666-6666-6666-666666666666\",\n \"percentage\": 10\n }\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.emidat.com/v2/composites")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"BLENDED_CEMENT_MIX_A\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Blended Cement Mix A\",\n \"composite_type\": \"chemicals\",\n \"items\": [\n {\n \"elementary_id\": \"22222222-2222-2222-2222-222222222222\",\n \"percentage\": 60\n },\n {\n \"elementary_id\": \"55555555-5555-5555-5555-555555555555\",\n \"percentage\": 30\n },\n {\n \"elementary_id\": \"66666666-6666-6666-6666-666666666666\",\n \"percentage\": 10\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/composites")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"BLENDED_CEMENT_MIX_A\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Blended Cement Mix A\",\n \"composite_type\": \"chemicals\",\n \"items\": [\n {\n \"elementary_id\": \"22222222-2222-2222-2222-222222222222\",\n \"percentage\": 60\n },\n {\n \"elementary_id\": \"55555555-5555-5555-5555-555555555555\",\n \"percentage\": 30\n },\n {\n \"elementary_id\": \"66666666-6666-6666-6666-666666666666\",\n \"percentage\": 10\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 60
}
],
"created_at": "2023-11-07T05:31:56Z"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 60
}
],
"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
}Composites
Create composite
Creates a composite at one of your plants. A composite is a manufacturer-defined mix of materials by percentage.
Idempotent create — a replay of the same Idempotency-Key returns the
original response (200); otherwise a new composite is created
(201). Your external_id must be unique: reusing one returns 409. See
External IDs.
POST
/
v2
/
composites
Create composite
curl --request POST \
--url https://api.emidat.com/v2/composites \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "22222222-2222-2222-2222-222222222222",
"percentage": 60
},
{
"elementary_id": "55555555-5555-5555-5555-555555555555",
"percentage": 30
},
{
"elementary_id": "66666666-6666-6666-6666-666666666666",
"percentage": 10
}
]
}
'import requests
url = "https://api.emidat.com/v2/composites"
payload = {
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "11111111-1111-1111-1111-111111111111",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "22222222-2222-2222-2222-222222222222",
"percentage": 60
},
{
"elementary_id": "55555555-5555-5555-5555-555555555555",
"percentage": 30
},
{
"elementary_id": "66666666-6666-6666-6666-666666666666",
"percentage": 10
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'BLENDED_CEMENT_MIX_A',
plant_id: '11111111-1111-1111-1111-111111111111',
name: 'Blended Cement Mix A',
composite_type: 'chemicals',
items: [
{elementary_id: '22222222-2222-2222-2222-222222222222', percentage: 60},
{elementary_id: '55555555-5555-5555-5555-555555555555', percentage: 30},
{elementary_id: '66666666-6666-6666-6666-666666666666', percentage: 10}
]
})
};
fetch('https://api.emidat.com/v2/composites', 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/composites",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'BLENDED_CEMENT_MIX_A',
'plant_id' => '11111111-1111-1111-1111-111111111111',
'name' => 'Blended Cement Mix A',
'composite_type' => 'chemicals',
'items' => [
[
'elementary_id' => '22222222-2222-2222-2222-222222222222',
'percentage' => 60
],
[
'elementary_id' => '55555555-5555-5555-5555-555555555555',
'percentage' => 30
],
[
'elementary_id' => '66666666-6666-6666-6666-666666666666',
'percentage' => 10
]
]
]),
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/composites"
payload := strings.NewReader("{\n \"external_id\": \"BLENDED_CEMENT_MIX_A\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Blended Cement Mix A\",\n \"composite_type\": \"chemicals\",\n \"items\": [\n {\n \"elementary_id\": \"22222222-2222-2222-2222-222222222222\",\n \"percentage\": 60\n },\n {\n \"elementary_id\": \"55555555-5555-5555-5555-555555555555\",\n \"percentage\": 30\n },\n {\n \"elementary_id\": \"66666666-6666-6666-6666-666666666666\",\n \"percentage\": 10\n }\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.emidat.com/v2/composites")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"BLENDED_CEMENT_MIX_A\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Blended Cement Mix A\",\n \"composite_type\": \"chemicals\",\n \"items\": [\n {\n \"elementary_id\": \"22222222-2222-2222-2222-222222222222\",\n \"percentage\": 60\n },\n {\n \"elementary_id\": \"55555555-5555-5555-5555-555555555555\",\n \"percentage\": 30\n },\n {\n \"elementary_id\": \"66666666-6666-6666-6666-666666666666\",\n \"percentage\": 10\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.emidat.com/v2/composites")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"BLENDED_CEMENT_MIX_A\",\n \"plant_id\": \"11111111-1111-1111-1111-111111111111\",\n \"name\": \"Blended Cement Mix A\",\n \"composite_type\": \"chemicals\",\n \"items\": [\n {\n \"elementary_id\": \"22222222-2222-2222-2222-222222222222\",\n \"percentage\": 60\n },\n {\n \"elementary_id\": \"55555555-5555-5555-5555-555555555555\",\n \"percentage\": 30\n },\n {\n \"elementary_id\": \"66666666-6666-6666-6666-666666666666\",\n \"percentage\": 10\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 60
}
],
"created_at": "2023-11-07T05:31:56Z"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "BLENDED_CEMENT_MIX_A",
"plant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Blended Cement Mix A",
"composite_type": "chemicals",
"items": [
{
"elementary_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"percentage": 60
}
],
"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
}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.
Headers
Optional client-generated key of 1–255 characters (e.g. a UUID) that makes
a create idempotent — the only mechanism that does so. A replay carrying the same
key returns the original response unchanged (200); reusing a key with a
different request body (compared byte for byte) or create endpoint is
rejected with 409 err_idempotency_key_reused. Concurrent requests with
the same key receive 409 err_idempotency_in_progress. Keys are scoped
to your manufacturer; successful responses are retained for 6h without
extending that window on replay. Current permissions are required on
every retry; product-instance replays also require the original
production-data scopes. Deduplication is best effort: Redis data loss
can end the window early, and Redis unavailability, timeouts, or unreadable
cache entries can allow creation without replay protection. Successful
creates still return 201 if caching fails. Redis waits share a two-second
budget excluding creation time. Incompatible replay-format upgrades
reset replay protection, so retries across that boundary can create again.
An interrupted create can reserve the key for up to 6h.
See External IDs for recovery guidance.
Required string length:
1 - 255Body
application/json
Your own code for this composite. Required; pass null if unset.
A non-null code must be unique among your active composites; a
duplicate returns 409 (see External IDs).
Example:
"BLENDED_CEMENT_MIX_A"
The plant's Emidat UUID.
Human-readable composite name. Must be unique among your active
composites at this plant; a duplicate returns 409.
Example:
"Blended Cement Mix A"
Composite category. Every material in the composite must belong to a material type allowed for this category.
Available options:
chemicals, plastics, electronics, facing_layers, glass, fittings, resins, plastics_metal, mechanical_composites, glass_chemicals, glass_carbon_reinforced_polymers, masterbatches, processed_plastics, fabrics, furniture_component Materials that constitute this composite — at least 2, no
duplicates. Percentages across all entries must sum to exactly 100.
Every material must be allowed for the composite_type.
Minimum array length:
2Show child attributes
Show child attributes
Response
Returned unchanged — an Idempotency-Key replay.
Emidat-assigned composite UUID.
Your own code for this composite, null when none is set. Supplier
products reference the composite by its Emidat id; BOM entries
reference those supplier products, not the composite directly.
Example:
"BLENDED_CEMENT_MIX_A"
The plant's Emidat UUID.
Human-readable composite name.
Example:
"Blended Cement Mix A"
Composite category. Every material in the composite must belong to a material type allowed for this category.
Available options:
chemicals, plastics, electronics, facing_layers, glass, fittings, resins, plastics_metal, mechanical_composites, glass_chemicals, glass_carbon_reinforced_polymers, masterbatches, processed_plastics, fabrics, furniture_component Ingredients constituting this composite, with percentages summing to 100.
Show child attributes
Show child attributes
⌘I