An 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-IMPORT-ID"
Response
The machine data items were ingested successfully.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cula Docs","colors":{"primary":"#3772FF","light":"#6593FF","dark":"#1C3B84"},"logo":{"light":"https://mintcdn.com/culatechnologies/VBk50tt2s0Ltfxst/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=VBk50tt2s0Ltfxst\u0026q=85\u0026s=461159ff3d23c746d71402d2feecf532","dark":"https://mintcdn.com/culatechnologies/VBk50tt2s0Ltfxst/images/logo-light.svg?fit=max\u0026auto=format\u0026n=VBk50tt2s0Ltfxst\u0026q=85\u0026s=66a21b9dc3090bdcf34e0d79ff9c3846"},"favicon":"https://mintcdn.com/culatechnologies/VBk50tt2s0Ltfxst/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=VBk50tt2s0Ltfxst\u0026q=85\u0026s=461159ff3d23c746d71402d2feecf532","footer":{"socials":{"website":"https://cula.tech","linkedin":"https://www.linkedin.com/company/cula-technologies"}},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"interaction":{"drilldown":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"culatechnologies","hasAudioNarration":false,"actualSubdomain":"culatechnologies","customDomains":["docs.cula.tech"],"gitSource":{"type":"github","owner":"cula-technologies","repo":"cula-platform","deployBranch":"main","contentDirectory":"public-docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adf8972d13963272de949d8","collectionId":"d64c3bdf-da31-43be-aa1c-8d0130504c12","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf8972d13963272de949d8"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6ae4bd45f0f0e506e2343d4c","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":84},{"language":"default","tag":"Material Tracking","count":52},{"language":"default","tag":"General","count":16},{"language":"default","tag":"Machine Data","count":16},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Deliveries","count":11},{"language":"default","tag":"Material Batches","count":11},{"language":"default","tag":"Machine Data Annotations","count":7},{"language":"default","tag":"Material Conversions","count":7},{"language":"default","tag":"Material Sourcings","count":7}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/machine-data-imports/import-machine-data","slug":"/api-reference/machine-data-imports/import-machine-data","pageMetadata":{"title":"Import machine data","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json post /machine-data-imports","href":"/api-reference/machine-data-imports/import-machine-data","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Import machine data","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json post /machine-data-imports","href":"/api-reference/machine-data-imports/import-machine-data","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"parameters":["3392254b-bb4e-4732-a281-89aeff500b1f"],"requestBody":"9879c30c-06f9-462d-a7d5-27e0c640f981","responses":{"201":"7e678450-64da-430a-9bdb-e37a749ac4ba","400":"e61611d3-1061-4b22-977f-17533b92dbec","401":"a60f7814-cb43-4cee-824e-dff167ce2555","409":"cf38d738-5033-492f-96ee-096f295675b0","429":"bb82a65b-9d41-4eb3-a63c-f447132638a6","500":"df6f6306-6db8-47a4-8103-4d1e88e4df3c"},"security":["322a3b66-1d43-4f5d-8f75-bf2308261c6a"],"summary":"Import machine data","tags":["Machine Data Imports"],"method":"post","type":"path","servers":["66bbfecc-695b-4944-9986-0e06121643e7"],"path":"/machine-data-imports","baseUrlOptions":["https://api.demo.cula.earth/tracking/v1"],"title":"Import machine data","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3392254b-bb4e-4732-a281-89aeff500b1f":{"name":"Cula-Organisation-Id","in":"header","description":"ID of the organisation the request operates on behalf of (e.g. `org_...`). Must be an organisation the API client has access to.","required":true,"schema":{"type":"string","example":"org_01k83mfmhgchya944v86ryvhpq","isRequired":true,"description":"ID of the organisation the request operates on behalf of (e.g. `org_...`). Must be an organisation the API client has access to.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"Import mode. Only `sync` is currently supported.","enum":["sync"],"example":"sync","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"items":{"minItems":1,"maxItems":200,"description":"Machine data items to ingest. Between 1 and 200 items per request.","type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"Measurement timestamp. ISO 8601 date-time with an explicit UTC offset (`Z` or `±hh:mm`), up to millisecond precision.","example":"2025-10-25T13:02:52.932+02:00","isRequired":true,"uniqueKey":"\\items.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"machine_variable_id":{"type":"string","example":"mvr_01kae7a2kpkcqwy7fwk2fft11h","description":"The machine variable this value belongs to.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].machine_variable_id","typeLabel":"string"},"value":{"oneOf":[{"type":"number","description":"Raw measured value. The server applies the machine variable's factor and validates it against the variable's `value_type`. Boolean values (or 0/1) are accepted for boolean-typed variables.","example":33.3,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].value.oneOf.0","typeLabel":"number"},{"type":"boolean","description":"Raw measured value. The server applies the machine variable's factor and validates it against the variable's `value_type`. Boolean values (or 0/1) are accepted for boolean-typed variables.","example":33.3,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].value.oneOf.1","typeLabel":"boolean"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].value","typeLabel":"number | boolean"}},"required":["timestamp","machine_variable_id","value"],"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"external_id":{"type":"string","example":"MY-IMPORT-ID","description":"An 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.","maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9\\-_]+$","uniqueKey":"external_id","typeLabel":"string"}},"required":["type","items"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"sync","items":[{"timestamp":"2025-10-25T13:02:52.932+02:00","machine_variable_id":"mvr_01kae7a2kpkcqwy7fwk2fft11h","value":33.3}],"external_id":"MY-IMPORT-ID"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7e678450-64da-430a-9bdb-e37a749ac4ba":{"description":"The machine data items were ingested successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"mdi_01knwph011nqfnv5frjh3e32wq","description":"Unique identifier of the machine data import.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"type":{"type":"string","description":"Import mode the request was processed with.","enum":["sync"],"example":"sync","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"item_count":{"type":"number","example":1,"description":"Number of machine data items in the import.","isRequired":true,"uniqueKey":"item_count","typeLabel":"number"},"external_id":{"oneOf":[{"type":"string","example":"MY-IMPORT-ID","description":"The external ID you assigned to this import (if any).","isRequired":true,"uniqueKey":"external_id.oneOf.0","typeLabel":"string"},{"type":"null","example":"MY-IMPORT-ID","description":"The external ID you assigned to this import (if any).","isRequired":true,"uniqueKey":"external_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"external_id","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","example":"2025-10-25T13:02:52.932Z","description":"When the import was recorded.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"}},"required":["id","type","item_count","external_id","created_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"mdi_01knwph011nqfnv5frjh3e32wq","type":"sync","item_count":1,"external_id":"MY-IMPORT-ID","created_at":"2025-10-25T13:02:52.932Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"e61611d3-1061-4b22-977f-17533b92dbec":{"description":"Invalid request payload or parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"The field limit must not be greater than 50.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"bad_request","message":"The field limit must not be greater than 50."},"examples":{"Example":{"title":"Example","value":{"code":"bad_request","message":"The field limit must not be greater than 50."}}},"exampleType":"examples"}},"exampleType":"examples"},"a60f7814-cb43-4cee-824e-dff167ce2555":{"description":"Missing or invalid access token.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"The field limit must not be greater than 50.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"unauthorized","message":"Invalid or expired token"},"examples":{"Example":{"title":"Example","value":{"code":"unauthorized","message":"Invalid or expired token"}}},"exampleType":"examples"}},"exampleType":"examples"},"cf38d738-5033-492f-96ee-096f295675b0":{"description":"Conflicting object state.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"The field limit must not be greater than 50.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"conflict","message":"There exists already an object with external ID MY-CUSTOM-ID within this organisation."},"examples":{"Example":{"title":"Example","value":{"code":"conflict","message":"There exists already an object with external ID MY-CUSTOM-ID within this organisation."}}},"exampleType":"examples"}},"exampleType":"examples"},"bb82a65b-9d41-4eb3-a63c-f447132638a6":{"description":"The API client sent more requests than its limit allows. Try again after the time given in the `Retry-After` header.","headers":{"Retry-After":{"description":"Seconds until the API client can send requests again.","schema":{"type":"integer","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"The field limit must not be greater than 50.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"too_many_requests","message":"Too many requests. Try again after the time given in the Retry-After header."},"examples":{"Example":{"title":"Example","value":{"code":"too_many_requests","message":"Too many requests. Try again after the time given in the Retry-After header."}}},"exampleType":"examples"}},"exampleType":"examples"},"df6f6306-6db8-47a4-8103-4d1e88e4df3c":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"The field limit must not be greater than 50.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"internal_server_error","message":"Internal server error."},"examples":{"Example":{"title":"Example","value":{"code":"internal_server_error","message":"Internal server error."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"322a3b66-1d43-4f5d-8f75-bf2308261c6a":{"AccessToken":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.demo.cula.earth/oauth2/token","scopes":{}}},"description":"OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access.","scopes":[],"schemeName":"AccessToken"}}},"servers":{"66bbfecc-695b-4944-9986-0e06121643e7":{"url":"https://api.demo.cula.earth/tracking/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.demo.cula.earth/oauth2/token","scopes":{}}},"description":"OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access.","scopes":[],"schemeName":"AccessToken"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2.0 client credentials. Exchange your client_id and client_secret for an access token scoped to the organisation that provides data access.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AccessToken","name":"Authorization"}],"title":"AccessToken"}]},"originalFileLocation":"openapi.json"},"subdomain":"culatechnologies","siteName":"Cula Docs","title":"Import machine data - Cula Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T15:52:44.691Z","originalFileLocation":"api-reference/machine-data-imports/import-machine-data.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Cula Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Import machine data - Cula Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cula Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://culatechnologies.mintlify.app/_mintlify/api/og/v2?division=Machine+Data+Imports\u0026amp;title=Import+machine+data\u0026amp;theme=9a11bf9e401b5ff7ee13840b\u0026amp;signature=eec95f1733442bcc7717245ab3b4bd556eebca4d3e21f489e583e64da51ca9dd\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Import machine data - Cula Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://culatechnologies.mintlify.app/_mintlify/api/og/v2?division=Machine+Data+Imports\u0026amp;title=Import+machine+data\u0026amp;theme=9a11bf9e401b5ff7ee13840b\u0026amp;signature=eec95f1733442bcc7717245ab3b4bd556eebca4d3e21f489e583e64da51ca9dd\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/culatechnologies/-_tSlJRddN-rDXo_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cula Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3772FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/machine-data-imports/import-machine-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cula.tech/#organization\",\"name\":\"Cula Docs\",\"url\":\"https://docs.cula.tech\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/culatechnologies/VBk50tt2s0Ltfxst/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=VBk50tt2s0Ltfxst\u0026q=85\u0026s=461159ff3d23c746d71402d2feecf532\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cula.tech#website\",\"name\":\"Cula Docs\",\"url\":\"https://docs.cula.tech\",\"publisher\":{\"@id\":\"https://docs.cula.tech/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data#webpage\",\"url\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data\",\"name\":\"Import machine data\",\"dateModified\":\"2026-10-30T15:52:44.691Z\",\"isPartOf\":{\"@id\":\"https://docs.cula.tech#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Machine Data\",\"item\":\"https://docs.cula.tech/api-reference/machine-data-sources/list-machine-data-sources\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Import machine data\",\"item\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data#apireference\",\"headline\":\"Import machine data\",\"name\":\"Import machine data\",\"url\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cula.tech/api-reference/machine-data-imports/import-machine-data#webpage\"},\"dateModified\":\"2026-10-30T15:52:44.691Z\",\"publisher\":{\"@id\":\"https://docs.cula.tech/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cula.tech#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cula Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cula Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction"}]},{"tab":"API Reference","groups":[{"group":"General","pages":[{"group":"Organisations","pages":[{"title":"List organisations","deprecated":null,"version":null,"openapi":"/openapi.json get /organisations","href":"/api-reference/organisations/list-organisations"},{"title":"Get an organisation","deprecated":null,"version":null,"openapi":"/openapi.json get /organisations/{id}","href":"/api-reference/organisations/get-an-organisation"},{"title":"Create an organisation","deprecated":null,"version":null,"openapi":"/openapi.json post /organisations","href":"/api-reference/organisations/create-an-organisation"}]},{"group":"Sites","pages":[{"title":"List sites","deprecated":null,"version":null,"openapi":"/openapi.json get /sites","href":"/api-reference/sites/list-sites"},{"title":"Get a site","deprecated":null,"version":null,"openapi":"/openapi.json get /sites/{id}","href":"/api-reference/sites/get-a-site"},{"title":"Create a site","deprecated":null,"version":null,"openapi":"/openapi.json post /sites","href":"/api-reference/sites/create-a-site"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/openapi.json get /files","href":"/api-reference/files/list-files"},{"title":"Get a file","deprecated":null,"version":null,"openapi":"/openapi.json get /files/{id}","href":"/api-reference/files/get-a-file"},{"title":"Download a file","deprecated":null,"version":null,"openapi":"/openapi.json get /files/{id}/contents","href":"/api-reference/files/download-a-file"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/openapi.json post /files","href":"/api-reference/files/upload-a-file"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Get a webhook","deprecated":null,"version":null,"openapi":"/openapi.json get /webhooks/{id}","href":"/api-reference/webhooks/get-a-webhook"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Receive an event","version":null,"deprecated":null,"openapi":"/openapi.json webhook receiveEvent","href":"/api-reference/webhooks/receive-an-event"}]},{"group":"Deprecated Endpoints","pages":[{"title":"Get a document","deprecated":true,"version":null,"openapi":"/openapi.json get /documents/{id}","href":"/api-reference/documents/get-a-document"}]}]},{"group":"Material Tracking","pages":[{"group":"Material Pools","pages":[{"title":"List material pools","deprecated":null,"version":null,"openapi":"/openapi.json get /material-pools","href":"/api-reference/material-pools/list-material-pools"},{"title":"Get a material pool","deprecated":null,"version":null,"openapi":"/openapi.json get /material-pools/{id}","href":"/api-reference/material-pools/get-a-material-pool"},{"title":"Create a material pool","deprecated":null,"version":null,"openapi":"/openapi.json post /material-pools","href":"/api-reference/material-pools/create-a-material-pool"},{"title":"Update a material pool","deprecated":null,"version":null,"openapi":"/openapi.json patch /material-pools/{id}","href":"/api-reference/material-pools/update-a-material-pool"},{"title":"Delete a material pool","deprecated":null,"version":null,"openapi":"/openapi.json delete /material-pools/{id}","href":"/api-reference/material-pools/delete-a-material-pool"}]},{"group":"Material Batches","pages":[{"title":"List material batch configs","deprecated":null,"version":null,"openapi":"/openapi.json get /material-batch-configs","href":"/api-reference/material-batch-configs/list-material-batch-configs"},{"title":"Get a material batch config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-batch-configs/{id}","href":"/api-reference/material-batch-configs/get-a-material-batch-config"},{"title":"List versions of a material batch config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-batch-configs/{id}/versions","href":"/api-reference/material-batch-configs/list-versions-of-a-material-batch-config"},{"title":"Get a specific material batch config version","deprecated":null,"version":null,"openapi":"/openapi.json get /material-batch-configs/{id}/versions/{version_id}","href":"/api-reference/material-batch-configs/get-a-specific-material-batch-config-version"},{"title":"List material batches","deprecated":null,"version":null,"openapi":"/openapi.json get /material-batches","href":"/api-reference/material-batches/list-material-batches"},{"title":"Get a material batch","deprecated":null,"version":null,"openapi":"/openapi.json get /material-batches/{id}","href":"/api-reference/material-batches/get-a-material-batch"},{"title":"Create a material batch","deprecated":null,"version":null,"openapi":"/openapi.json post /material-batches","href":"/api-reference/material-batches/create-a-material-batch"},{"title":"Update a material batch","deprecated":null,"version":null,"openapi":"/openapi.json patch /material-batches/{id}","href":"/api-reference/material-batches/update-a-material-batch"},{"title":"Delete a material batch","deprecated":null,"version":null,"openapi":"/openapi.json delete /material-batches/{id}","href":"/api-reference/material-batches/delete-a-material-batch"},{"title":"Attach a file to a material batch","deprecated":null,"version":null,"openapi":"/openapi.json post /material-batches/{id}/files/{file_id}","href":"/api-reference/material-batches/attach-a-file-to-a-material-batch"},{"title":"Detach a file from a material batch","deprecated":null,"version":null,"openapi":"/openapi.json delete /material-batches/{id}/files/{file_id}","href":"/api-reference/material-batches/detach-a-file-from-a-material-batch"}]},{"group":"Material Containers","pages":[{"title":"List material containers","deprecated":null,"version":null,"openapi":"/openapi.json get /material-containers","href":"/api-reference/material-containers/list-material-containers"},{"title":"Get a material container","deprecated":null,"version":null,"openapi":"/openapi.json get /material-containers/{id}","href":"/api-reference/material-containers/get-a-material-container"}]},{"group":"Material Sourcings","pages":[{"title":"List material sourcing configs","deprecated":null,"version":null,"openapi":"/openapi.json get /material-sourcing-configs","href":"/api-reference/material-sourcing-configs/list-material-sourcing-configs"},{"title":"Get a material sourcing config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-sourcing-configs/{id}","href":"/api-reference/material-sourcing-configs/get-a-material-sourcing-config"},{"title":"List versions of a material sourcing config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-sourcing-configs/{id}/versions","href":"/api-reference/material-sourcing-configs/list-versions-of-a-material-sourcing-config"},{"title":"Get a specific material sourcing config version","deprecated":null,"version":null,"openapi":"/openapi.json get /material-sourcing-configs/{id}/versions/{version_id}","href":"/api-reference/material-sourcing-configs/get-a-specific-material-sourcing-config-version"},{"title":"List material sourcings","deprecated":null,"version":null,"openapi":"/openapi.json get /material-sourcings","href":"/api-reference/material-sourcings/list-material-sourcings"},{"title":"Get a material sourcing","deprecated":null,"version":null,"openapi":"/openapi.json get /material-sourcings/{id}","href":"/api-reference/material-sourcings/get-a-material-sourcing"},{"title":"Create a material sourcing","deprecated":null,"version":null,"openapi":"/openapi.json post /material-sourcings","href":"/api-reference/material-sourcings/create-a-material-sourcing"}]},{"group":"Material Conversions","pages":[{"title":"List material conversion configs","deprecated":null,"version":null,"openapi":"/openapi.json get /material-conversion-configs","href":"/api-reference/material-conversion-configs/list-material-conversion-configs"},{"title":"Get a material conversion config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-conversion-configs/{id}","href":"/api-reference/material-conversion-configs/get-a-material-conversion-config"},{"title":"List versions of a material conversion config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-conversion-configs/{id}/versions","href":"/api-reference/material-conversion-configs/list-versions-of-a-material-conversion-config"},{"title":"Get a specific material conversion config version","deprecated":null,"version":null,"openapi":"/openapi.json get /material-conversion-configs/{id}/versions/{version_id}","href":"/api-reference/material-conversion-configs/get-a-specific-material-conversion-config-version"},{"title":"List material conversions","deprecated":null,"version":null,"openapi":"/openapi.json get /material-conversions","href":"/api-reference/material-conversions/list-material-conversions"},{"title":"Get a material conversion","deprecated":null,"version":null,"openapi":"/openapi.json get /material-conversions/{id}","href":"/api-reference/material-conversions/get-a-material-conversion"},{"title":"Create a material conversion","deprecated":null,"version":null,"openapi":"/openapi.json post /material-conversions","href":"/api-reference/material-conversions/create-a-material-conversion"}]},{"group":"Material Utilizations","pages":[{"title":"List material utilization configs","deprecated":null,"version":null,"openapi":"/openapi.json get /material-utilization-configs","href":"/api-reference/material-utilization-configs/list-material-utilization-configs"},{"title":"Get a material utilization config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-utilization-configs/{id}","href":"/api-reference/material-utilization-configs/get-a-material-utilization-config"},{"title":"List versions of a material utilization config","deprecated":null,"version":null,"openapi":"/openapi.json get /material-utilization-configs/{id}/versions","href":"/api-reference/material-utilization-configs/list-versions-of-a-material-utilization-config"},{"title":"Get a specific material utilization config version","deprecated":null,"version":null,"openapi":"/openapi.json get /material-utilization-configs/{id}/versions/{version_id}","href":"/api-reference/material-utilization-configs/get-a-specific-material-utilization-config-version"},{"title":"List material utilizations","deprecated":null,"version":null,"openapi":"/openapi.json get /material-utilizations","href":"/api-reference/material-utilizations/list-material-utilizations"},{"title":"Get a material utilization","deprecated":null,"version":null,"openapi":"/openapi.json get /material-utilizations/{id}","href":"/api-reference/material-utilizations/get-a-material-utilization"},{"title":"Create a material utilization","deprecated":null,"version":null,"openapi":"/openapi.json post /material-utilizations","href":"/api-reference/material-utilizations/create-a-material-utilization"}]},{"group":"Deliveries","pages":[{"title":"List delivery configs","deprecated":null,"version":null,"openapi":"/openapi.json get /delivery-configs","href":"/api-reference/delivery-configs/list-delivery-configs"},{"title":"Get a delivery config","deprecated":null,"version":null,"openapi":"/openapi.json get /delivery-configs/{id}","href":"/api-reference/delivery-configs/get-a-delivery-config"},{"title":"List versions of a delivery config","deprecated":null,"version":null,"openapi":"/openapi.json get /delivery-configs/{id}/versions","href":"/api-reference/delivery-configs/list-versions-of-a-delivery-config"},{"title":"Get a specific delivery config version","deprecated":null,"version":null,"openapi":"/openapi.json get /delivery-configs/{id}/versions/{version_id}","href":"/api-reference/delivery-configs/get-a-specific-delivery-config-version"},{"title":"List deliveries","deprecated":null,"version":null,"openapi":"/openapi.json get /deliveries","href":"/api-reference/deliveries/list-deliveries"},{"title":"Get a delivery","deprecated":null,"version":null,"openapi":"/openapi.json get /deliveries/{id}","href":"/api-reference/deliveries/get-a-delivery"},{"title":"Create a delivery","deprecated":null,"version":null,"openapi":"/openapi.json post /deliveries","href":"/api-reference/deliveries/create-a-delivery"},{"title":"Update a delivery","deprecated":null,"version":null,"openapi":"/openapi.json patch /deliveries/{id}","href":"/api-reference/deliveries/update-a-delivery"},{"title":"Delete a delivery","deprecated":null,"version":null,"openapi":"/openapi.json delete /deliveries/{id}","href":"/api-reference/deliveries/delete-a-delivery"},{"title":"Attach a file to a delivery","deprecated":null,"version":null,"openapi":"/openapi.json post /deliveries/{id}/files/{file_id}","href":"/api-reference/deliveries/attach-a-file-to-a-delivery"},{"title":"Detach a file from a delivery","deprecated":null,"version":null,"openapi":"/openapi.json delete /deliveries/{id}/files/{file_id}","href":"/api-reference/deliveries/detach-a-file-from-a-delivery"}]},{"group":"Sinks","pages":[{"title":"List sinks","deprecated":null,"version":null,"openapi":"/openapi.json get /sinks","href":"/api-reference/sinks/list-sinks"},{"title":"Get a sink","deprecated":null,"version":null,"openapi":"/openapi.json get /sinks/{id}","href":"/api-reference/sinks/get-a-sink"}]}]},{"group":"Machine Data","pages":[{"group":"Machine Data Sources","pages":[{"title":"List machine data sources","deprecated":null,"version":null,"openapi":"/openapi.json get /machine-data-sources","href":"/api-reference/machine-data-sources/list-machine-data-sources"},{"title":"Get a machine data source","deprecated":null,"version":null,"openapi":"/openapi.json get /machine-data-sources/{id}","href":"/api-reference/machine-data-sources/get-a-machine-data-source"}]},{"group":"Machines (deprecated)","pages":[{"title":"List machines","deprecated":true,"version":null,"openapi":"/openapi.json get /machines","href":"/api-reference/machines/list-machines"},{"title":"Get a machine","deprecated":true,"version":null,"openapi":"/openapi.json get /machines/{id}","href":"/api-reference/machines/get-a-machine"}]},{"group":"Machine Variables","pages":[{"title":"List machine variables","deprecated":null,"version":null,"openapi":"/openapi.json get /machine-variables","href":"/api-reference/machine-variables/list-machine-variables"},{"title":"Get a machine variable","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /machine-variables/{id}","href":"/api-reference/machine-variables/get-a-machine-variable"}]},{"group":"Machine Data Imports","pages":[{"title":"Import machine data","deprecated":null,"version":null,"openapi":"/openapi.json post /machine-data-imports","href":"/api-reference/machine-data-imports/import-machine-data"},{"title":"List machine data imports","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /machine-data-imports","href":"/api-reference/machine-data-imports/list-machine-data-imports"},{"title":"Get a machine data import","deprecated":null,"version":null,"openapi":"/openapi.json get /machine-data-imports/{id}","href":"/api-reference/machine-data-imports/get-a-machine-data-import"}]},{"group":"Machine Data Annotations","pages":[{"title":"List machine data annotations","deprecated":null,"version":null,"openapi":"/openapi.json get /machine-data-annotations","href":"/api-reference/machine-data-annotations/list-machine-data-annotations"},{"title":"Get a machine data annotation","deprecated":null,"version":null,"openapi":"/openapi.json get /machine-data-annotations/{id}","href":"/api-reference/machine-data-annotations/get-a-machine-data-annotation"},{"title":"Create a machine data annotation","deprecated":null,"version":null,"openapi":"/openapi.json post /machine-data-annotations","href":"/api-reference/machine-data-annotations/create-a-machine-data-annotation"},{"title":"Update a machine data annotation","deprecated":null,"version":null,"openapi":"/openapi.json patch /machine-data-annotations/{id}","href":"/api-reference/machine-data-annotations/update-a-machine-data-annotation"},{"title":"Delete a machine data annotation","deprecated":null,"version":null,"openapi":"/openapi.json delete /machine-data-annotations/{id}","href":"/api-reference/machine-data-annotations/delete-a-machine-data-annotation"},{"title":"Attach a machine variable to a machine data annotation","deprecated":null,"version":null,"openapi":"/openapi.json post /machine-data-annotations/{id}/machine-variables/{machine_variable_id}","href":"/api-reference/machine-data-annotations/attach-a-machine-variable-to-a-machine-data-annotation"},{"title":"Detach a machine variable from a machine data annotation","deprecated":null,"version":null,"openapi":"/openapi.json delete /machine-data-annotations/{id}/machine-variables/{machine_variable_id}","href":"/api-reference/machine-data-annotations/detach-a-machine-variable-from-a-machine-data-annotation"}]}]}]}]},"basePath":"","title":"Import machine data - Cula Docs","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}