---
title: "Import and normalize retail filament"
method: POST
path: "/v1/materials/import"
tags: ["Materials", "Public"]
---

# Import and normalize retail filament

`POST /v1/materials/import`

Imports one retail filament into the authenticated organization. Organization scope is resolved by authentication and is not accepted in the body.

## Request body

- object
  - `rawTitle` string, required
  - `brandHint` unknown
  - `materialTypeHint` unknown
  - `variantLabel` unknown
  - `colorNames` string[]
  - `colors` string[]
  - `specifications` unknown
  - `features` string[]
  - `source` unknown
  - `sourceUrl` unknown
  - `sourceProductId` unknown
  - `asin` unknown
  - `sku` unknown
  - `imageUrl` unknown
  - `price` unknown
  - `diameter` union
    - number
    - string
  - `inventory` object
    - `quantity` integer
    - `minimumStock` integer
    - `unit` string
    - `weightPerUnit` unknown
    - `location` unknown

## Response `200`

Default Response

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/versions/3b06bcb5f808/schema)