Textile — Fibers API

Manage fiber products with sustainability, commerce and fiber-specific attributes.

Endpoints

MethodPathDescription
GET/api/v1/textile/fibersList fibers, optionally filtered by supplierId
GET/api/v1/textile/fibers/{id}Get a single fiber
POST/api/v1/textile/fibersCreate a fiber product
PATCH/api/v1/textile/fibers/{id}Partially update a fiber
DELETE/api/v1/textile/fibers/{id}Delete a fiber

GET /api/v1/textile/fibers

Query parameterTypeRequired
supplierIduuid—
Shell
curl "{{BASE_URL}}/api/v1/textile/fibers?supplierId=3f2b9a1c-…"

Response 200 OK — JSON array of FiberProductDto.

POST /api/v1/textile/fibers

See the Textile concept page for the shared core fields.

Fiber-specific fields

FieldTypeDescription
fiberTypestringe.g. COTTON, POLYESTER, WOOL
stapleLengthMmnumberStaple length in mm
finenessMicronnumberFineness in micron
fiberOriginstringFree-form origin description (beyond country)

Example

Shell
curl -X POST {{BASE_URL}}/api/v1/textile/fibers \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Organic Cotton Fiber — Indian Long Staple",
    "code": "FIB-OC-IN",
    "supplierId": "3f2b9a1c-…",
    "composition": "100% organic cotton",
    "productOriginCountry": "IN",
    "gotsCertified": true,
    "organicContentPct": 100,
    "unitOfMeasure": "KG",
    "fiberType": "COTTON",
    "stapleLengthMm": 30,
    "finenessMicron": 4.2,
    "fiberOrigin": "Gujarat, India",
    "pricePerUnit": "2.40",
    "currency": "EUR",
    "available": true
  }'

Response 201 Created — FiberProductDto.

GET /api/v1/textile/fibers/{id}

  • 200 OK — FiberProductDto.
  • 404 Not Found — fiber does not exist in your tenant.

PATCH /api/v1/textile/fibers/{id}

Partial update over any of the documented fields.

DELETE /api/v1/textile/fibers/{id}

  • 204 No Content — deleted.
  • 404 Not Found — fiber does not exist in your tenant.

Fiber schema

FiberProductDto has textileCategory fixed to FIBER.

JSON
{
  "id": "fib-uuid…",
  "supplierId": "3f2b9a1c-…",
  "companyId": null,
  "userId": null,
  "name": "Organic Cotton Fiber — Indian Long Staple",
  "code": "FIB-OC-IN",
  "textileCategory": "FIBER",
  "description": null,
  "composition": "100% organic cotton",
  "productOriginCountry": "IN",
  "rawMaterialOriginCountry": null,
  "gotsCertified": true,
  "grsCertified": false,
  "oekoTexCertified": false,
  "cradleToCradle": false,
  "betterCotton": false,
  "recycledContentPct": null,
  "organicContentPct": 100,
  "available": true,
  "pricePerUnit": "2.40",
  "currency": "EUR",
  "unitOfMeasure": "KG",
  "metadata": null,
  "fiberType": "COTTON",
  "stapleLengthMm": 30,
  "finenessMicron": 4.2,
  "fiberOrigin": "Gujarat, India",
  "createdAt": "2026-04-21T10:00:00.000Z",
  "updatedAt": "2026-04-21T10:00:00.000Z"
}