Create a material conversion

curl --request POST \
  --url https://api.demo.cula.earth/tracking/v1/material-conversions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>' \
  --data '
{
  "config_id": "mcvc_01kyaas94dty6shm2d0j7zw9v8",
  "occurred_at": "2026-01-15T08:00:00Z",
  "external_id": "MY-CUSTOM-ID",
  "input_containers": [
    {
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "value": "<string>",
          "input_value": "<string>"
        }
      ]
    }
  ],
  "output_containers": [
    {
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "value": "<string>",
          "input_value": "<string>"
        }
      ]
    }
  ],
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "value": "<string>",
      "input_value": "<string>"
    }
  ]
}
'

import requests

url = "https://api.demo.cula.earth/tracking/v1/material-conversions"

payload = {
    "config_id": "mcvc_01kyaas94dty6shm2d0j7zw9v8",
    "occurred_at": "2026-01-15T08:00:00Z",
    "external_id": "MY-CUSTOM-ID",
    "input_containers": [
        {
            "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
            "data_points": [
                {
                    "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                    "value": "<string>",
                    "input_value": "<string>"
                }
            ]
        }
    ],
    "output_containers": [
        {
            "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
            "data_points": [
                {
                    "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                    "value": "<string>",
                    "input_value": "<string>"
                }
            ]
        }
    ],
    "data_points": [
        {
            "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
            "value": "<string>",
            "input_value": "<string>"
        }
    ]
}
headers = {
    "Cula-Organisation-Id": "<cula-organisation-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Cula-Organisation-Id': '<cula-organisation-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    config_id: 'mcvc_01kyaas94dty6shm2d0j7zw9v8',
    occurred_at: '2026-01-15T08:00:00Z',
    external_id: 'MY-CUSTOM-ID',
    input_containers: [
      {
        config_id: 'mcnc_01k102qfrwthwk6dsggr9y8evn',
        data_points: [
          {
            config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
            value: '<string>',
            input_value: '<string>'
          }
        ]
      }
    ],
    output_containers: [
      {
        config_id: 'mcnc_01k102qfrwthwk6dsggr9y8evn',
        data_points: [
          {
            config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
            value: '<string>',
            input_value: '<string>'
          }
        ]
      }
    ],
    data_points: [
      {
        config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
        value: '<string>',
        input_value: '<string>'
      }
    ]
  })
};

fetch('https://api.demo.cula.earth/tracking/v1/material-conversions', 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.demo.cula.earth/tracking/v1/material-conversions",
  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([
    'config_id' => 'mcvc_01kyaas94dty6shm2d0j7zw9v8',
    'occurred_at' => '2026-01-15T08:00:00Z',
    'external_id' => 'MY-CUSTOM-ID',
    'input_containers' => [
        [
                'config_id' => 'mcnc_01k102qfrwthwk6dsggr9y8evn',
                'data_points' => [
                                [
                                                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                                                'value' => '<string>',
                                                                'input_value' => '<string>'
                                ]
                ]
        ]
    ],
    'output_containers' => [
        [
                'config_id' => 'mcnc_01k102qfrwthwk6dsggr9y8evn',
                'data_points' => [
                                [
                                                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                                                'value' => '<string>',
                                                                'input_value' => '<string>'
                                ]
                ]
        ]
    ],
    'data_points' => [
        [
                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                'value' => '<string>',
                'input_value' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Cula-Organisation-Id: <cula-organisation-id>"
  ],
]);

$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.demo.cula.earth/tracking/v1/material-conversions"

	payload := strings.NewReader("{\n  \"config_id\": \"mcvc_01kyaas94dty6shm2d0j7zw9v8\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"input_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"output_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Cula-Organisation-Id", "<cula-organisation-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	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.demo.cula.earth/tracking/v1/material-conversions")
  .header("Cula-Organisation-Id", "<cula-organisation-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"config_id\": \"mcvc_01kyaas94dty6shm2d0j7zw9v8\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"input_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"output_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.demo.cula.earth/tracking/v1/material-conversions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Cula-Organisation-Id"] = '<cula-organisation-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"config_id\": \"mcvc_01kyaas94dty6shm2d0j7zw9v8\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"input_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"output_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "mcv_01k1k06s731c8dpsfc8beya4rt",
  "config_id": "mcvc_01kyaas94dty6shm2d0j7zw9v8",
  "config_version_id": "mcvcv_01krxsm2pxdgygx26jbyv4ztjy",
  "external_id": "MY-CUSTOM-ID",
  "display_id": "PYR-2026-01-15-1",
  "site": {
    "id": "ste_01k8g7aec6dt5zrtamc72ww446",
    "external_id": "SITE-EXT-0001"
  },
  "occurred_at": "2026-01-15T08:00:00Z",
  "created_at": "2026-01-15T08:00:00Z",
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
      "name": "Weight gross",
      "type": "short_text",
      "value": "<string>",
      "input_value": "<string>",
      "result_value": "<string>"
    }
  ],
  "input_containers": [
    {
      "id": "mcn_01kqz4g5cjzvwsnnps6q7183q3",
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "config_version_id": "mcncv_01kxs8mt2y4711mz04rqs14t0a",
      "status": "available",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ],
  "output_containers": [
    {
      "id": "mcn_01kqz4g5cjzvwsnnps6q7183q3",
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "config_version_id": "mcncv_01kxs8mt2y4711mz04rqs14t0a",
      "status": "available",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ]
}

{
  "code": "bad_request",
  "message": "The field limit must not be greater than 100."
}

{
  "code": "unauthorized",
  "message": "Invalid or expired token"
}

{
  "code": "conflict",
  "message": "There exists already an object with external ID MY-CUSTOM-ID within this organisation."
}

{
  "code": "internal_server_error",
  "message": "Internal server error."
}

POST

material-conversions

Create a material conversion

curl --request POST \
  --url https://api.demo.cula.earth/tracking/v1/material-conversions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>' \
  --data '
{
  "config_id": "mcvc_01kyaas94dty6shm2d0j7zw9v8",
  "occurred_at": "2026-01-15T08:00:00Z",
  "external_id": "MY-CUSTOM-ID",
  "input_containers": [
    {
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "value": "<string>",
          "input_value": "<string>"
        }
      ]
    }
  ],
  "output_containers": [
    {
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "value": "<string>",
          "input_value": "<string>"
        }
      ]
    }
  ],
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "value": "<string>",
      "input_value": "<string>"
    }
  ]
}
'

import requests

url = "https://api.demo.cula.earth/tracking/v1/material-conversions"

payload = {
    "config_id": "mcvc_01kyaas94dty6shm2d0j7zw9v8",
    "occurred_at": "2026-01-15T08:00:00Z",
    "external_id": "MY-CUSTOM-ID",
    "input_containers": [
        {
            "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
            "data_points": [
                {
                    "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                    "value": "<string>",
                    "input_value": "<string>"
                }
            ]
        }
    ],
    "output_containers": [
        {
            "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
            "data_points": [
                {
                    "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
                    "value": "<string>",
                    "input_value": "<string>"
                }
            ]
        }
    ],
    "data_points": [
        {
            "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
            "value": "<string>",
            "input_value": "<string>"
        }
    ]
}
headers = {
    "Cula-Organisation-Id": "<cula-organisation-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Cula-Organisation-Id': '<cula-organisation-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    config_id: 'mcvc_01kyaas94dty6shm2d0j7zw9v8',
    occurred_at: '2026-01-15T08:00:00Z',
    external_id: 'MY-CUSTOM-ID',
    input_containers: [
      {
        config_id: 'mcnc_01k102qfrwthwk6dsggr9y8evn',
        data_points: [
          {
            config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
            value: '<string>',
            input_value: '<string>'
          }
        ]
      }
    ],
    output_containers: [
      {
        config_id: 'mcnc_01k102qfrwthwk6dsggr9y8evn',
        data_points: [
          {
            config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
            value: '<string>',
            input_value: '<string>'
          }
        ]
      }
    ],
    data_points: [
      {
        config_id: 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
        value: '<string>',
        input_value: '<string>'
      }
    ]
  })
};

fetch('https://api.demo.cula.earth/tracking/v1/material-conversions', 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.demo.cula.earth/tracking/v1/material-conversions",
  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([
    'config_id' => 'mcvc_01kyaas94dty6shm2d0j7zw9v8',
    'occurred_at' => '2026-01-15T08:00:00Z',
    'external_id' => 'MY-CUSTOM-ID',
    'input_containers' => [
        [
                'config_id' => 'mcnc_01k102qfrwthwk6dsggr9y8evn',
                'data_points' => [
                                [
                                                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                                                'value' => '<string>',
                                                                'input_value' => '<string>'
                                ]
                ]
        ]
    ],
    'output_containers' => [
        [
                'config_id' => 'mcnc_01k102qfrwthwk6dsggr9y8evn',
                'data_points' => [
                                [
                                                                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                                                                'value' => '<string>',
                                                                'input_value' => '<string>'
                                ]
                ]
        ]
    ],
    'data_points' => [
        [
                'config_id' => 'dptc_01jxdp05c8r7dp4xf89pxcw28q',
                'value' => '<string>',
                'input_value' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Cula-Organisation-Id: <cula-organisation-id>"
  ],
]);

$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.demo.cula.earth/tracking/v1/material-conversions"

	payload := strings.NewReader("{\n  \"config_id\": \"mcvc_01kyaas94dty6shm2d0j7zw9v8\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"input_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"output_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Cula-Organisation-Id", "<cula-organisation-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	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.demo.cula.earth/tracking/v1/material-conversions")
  .header("Cula-Organisation-Id", "<cula-organisation-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"config_id\": \"mcvc_01kyaas94dty6shm2d0j7zw9v8\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"input_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"output_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.demo.cula.earth/tracking/v1/material-conversions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Cula-Organisation-Id"] = '<cula-organisation-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"config_id\": \"mcvc_01kyaas94dty6shm2d0j7zw9v8\",\n  \"occurred_at\": \"2026-01-15T08:00:00Z\",\n  \"external_id\": \"MY-CUSTOM-ID\",\n  \"input_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"output_containers\": [\n    {\n      \"config_id\": \"mcnc_01k102qfrwthwk6dsggr9y8evn\",\n      \"data_points\": [\n        {\n          \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n          \"value\": \"<string>\",\n          \"input_value\": \"<string>\"\n        }\n      ]\n    }\n  ],\n  \"data_points\": [\n    {\n      \"config_id\": \"dptc_01jxdp05c8r7dp4xf89pxcw28q\",\n      \"value\": \"<string>\",\n      \"input_value\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "mcv_01k1k06s731c8dpsfc8beya4rt",
  "config_id": "mcvc_01kyaas94dty6shm2d0j7zw9v8",
  "config_version_id": "mcvcv_01krxsm2pxdgygx26jbyv4ztjy",
  "external_id": "MY-CUSTOM-ID",
  "display_id": "PYR-2026-01-15-1",
  "site": {
    "id": "ste_01k8g7aec6dt5zrtamc72ww446",
    "external_id": "SITE-EXT-0001"
  },
  "occurred_at": "2026-01-15T08:00:00Z",
  "created_at": "2026-01-15T08:00:00Z",
  "data_points": [
    {
      "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
      "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
      "name": "Weight gross",
      "type": "short_text",
      "value": "<string>",
      "input_value": "<string>",
      "result_value": "<string>"
    }
  ],
  "input_containers": [
    {
      "id": "mcn_01kqz4g5cjzvwsnnps6q7183q3",
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "config_version_id": "mcncv_01kxs8mt2y4711mz04rqs14t0a",
      "status": "available",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ],
  "output_containers": [
    {
      "id": "mcn_01kqz4g5cjzvwsnnps6q7183q3",
      "config_id": "mcnc_01k102qfrwthwk6dsggr9y8evn",
      "config_version_id": "mcncv_01kxs8mt2y4711mz04rqs14t0a",
      "status": "available",
      "data_points": [
        {
          "config_id": "dptc_01jxdp05c8r7dp4xf89pxcw28q",
          "config_version_id": "dptcv_01kfxe6xgmw15gsf204jwj90g5",
          "name": "Weight gross",
          "type": "short_text",
          "value": "<string>",
          "input_value": "<string>",
          "result_value": "<string>"
        }
      ]
    }
  ]
}

{
  "code": "bad_request",
  "message": "The field limit must not be greater than 100."
}

{
  "code": "unauthorized",
  "message": "Invalid or expired token"
}

{
  "code": "conflict",
  "message": "There exists already an object with external ID MY-CUSTOM-ID within this organisation."
}

{
  "code": "internal_server_error",
  "message": "Internal server error."
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access.

Headers

Cula-Organisation-Id

string

required

ID of the organisation the request operates on behalf of (e.g. org_...). Must be an organisation the API client has access to.

Example:

"org_01k83mfmhgchya944v86ryvhpq"

Body

application/json

config_id

string

required

The ID of the material conversion config that defines the conversion to create.

Example:

"mcvc_01kyaas94dty6shm2d0j7zw9v8"

occurred_at

string<date-time>

When the conversion took place: an ISO 8601 date-time with an explicit UTC offset (Z or ±hh:mm). Defaults to now if omitted.

Example:

"2026-01-15T08:00:00Z"

external_id

string

A optional custom ID that can be set to an internal ID from your system. This ID must be unique within all objects of the organisation you operate in. You can later use this external ID to reference and query this object. Be aware that you can update this ID later. If you need an immutable ID, use the object ID returned when creating the object.

Required string length: 1 - 100

Pattern: ^[A-Za-z0-9\-_]+$

Example:

"MY-CUSTOM-ID"

input_containers

(New Container · object | Existing Container · object)[]

The containers the conversion consumes. Only applicable to non-unified configs (unified: false): describe each container against one of the config's input_configs via config_id.

Maximum array length: 100

Describes a new container to create, based on one of the container configs the flow's config lists.

New Container
Existing Container

Show child attributes

output_containers

(New Container · object | Existing Container · object)[]

The containers the conversion produces. Only applicable to non-unified configs (unified: false): describe each container against one of the config's output_configs via config_id.

Maximum array length: 100

Describes a new container to create, based on one of the container configs the flow's config lists.

New Container
Existing Container

Show child attributes

data_points

object[]

Values for the conversion's data points. When the config is unified (unified: true), the flat array spans the whole flow (conversion step, input and output containers); when unified is false, only the step's own data points — container values belong to the input_containers / output_containers items.

Maximum array length: 100

Show child attributes

Response

Material conversion created.

string

required

The ID of the material conversion.

Example:

"mcv_01k1k06s731c8dpsfc8beya4rt"

config_id

string

required

The ID of the config the conversion was created from.

Example:

"mcvc_01kyaas94dty6shm2d0j7zw9v8"

config_version_id

string

required

The ID of the exact config version the conversion was created from.

Example:

"mcvcv_01krxsm2pxdgygx26jbyv4ztjy"

external_id

string | null

required

Optional external ID of the conversion.

Example:

"MY-CUSTOM-ID"

display_id

string

required

Human-readable identifier.

Example:

"PYR-2026-01-15-1"

site

object

required

The site the conversion was executed at.

Show child attributes

occurred_at

string<date-time>

required

When the conversion took place.

Example:

"2026-01-15T08:00:00Z"

created_at

string<date-time>

required

When the conversion was recorded in Cula.

Example:

"2026-01-15T08:00:00Z"

data_points

required

Data points set on the conversion step itself.

Data point holding a single line of text.

Show child attributes

input_containers

object[]

required

The material containers the conversion consumed. Always returned, whether the config is unified or not.

Show child attributes

output_containers

object[]

required

The material containers the conversion produced. Always returned, whether the config is unified or not.

Show child attributes

General

Material Tracking

Machine Data

Create a material conversion

Authorizations

Headers

Body

Response