Retraced Product / Material Lines API

The Product / Material Lines API from Retraced — 3 operation(s) for product / material lines.

Operations 4

POST /api/v2/material-lines/ Create api material lines #
GET /api/v2/material-lines/ Get api material lines #
POST /api/v2/material-lines/delete Create api material lines delete #
PUT /api/v2/material-lines/{id} Replace api material lines by id #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/retraced-product-material-lines-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

retraced-product-material-lines-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Public API Reference Product / Material Lines API
  description: 'The retraced API comprises all publicly enabled options to make

    machine-to-machine changes in the retraced platform.'
  version: 2.938.1
servers: []
tags:
- name: Product / Material Lines
paths:
  /api/v2/material-lines/:
    post:
      tags:
      - Product / Material Lines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                styleId:
                  type: string
                  minLength: 1
                materialHeaderId:
                  type: string
                  minLength: 1
                parentId:
                  anyOf:
                  - type: string
                  - type: 'null'
                percentage:
                  type: number
                  minimum: 0
                  maximum: 100
                rawMaterialId:
                  type: string
                  minLength: 1
                weights:
                  type: number
                  minimum: 0
                weightUnit:
                  type: string
                  maxLength: 255
                level:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                position:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                countriesOfOrigin:
                  type: array
                  items:
                    type: string
                    minLength: 2
                    maxLength: 2
                forCompanyId:
                  type: string
                  minLength: 1
              required:
              - styleId
              - materialHeaderId
              - parentId
              - percentage
              - rawMaterialId
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      materialHeaderId:
                        type: string
                      rawMaterialId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      percentage:
                        anyOf:
                        - type: number
                        - type: 'null'
                      weights:
                        anyOf:
                        - type: number
                        - type: 'null'
                      weightUnit:
                        anyOf:
                        - type: string
                        - type: 'null'
                      parentId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      hierarchy:
                        anyOf:
                        - type: number
                        - type: 'null'
                      position:
                        anyOf:
                        - type: number
                        - type: 'null'
                      countriesOfOrigin:
                        anyOf:
                        - type: array
                          items:
                            type: string
                        - type: 'null'
                      createdAt:
                        type: string
                        format: date-time
                      createdByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      createdByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedAt:
                        type: string
                        format: date-time
                      updatedByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                    required:
                    - id
                    - materialHeaderId
                    - rawMaterialId
                    - percentage
                    - weights
                    - weightUnit
                    - parentId
                    - hierarchy
                    - position
                    - countriesOfOrigin
                    - createdAt
                    - createdByUserId
                    - createdByCompanyId
                    - updatedAt
                    - updatedByUserId
                    - updatedByCompanyId
                    additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Create api material lines
      x-summary-source: derived
      operationId: postApiV2MaterialLines
      x-operation-id-source: derived
    get:
      tags:
      - Product / Material Lines
      parameters:
      - schema:
          default: 1
          type: integer
          minimum: 1
          maximum: 9007199254740991
        in: query
        name: page
        required: false
      - schema:
          default: 20
          type: integer
          minimum: 1
          maximum: 100
        in: query
        name: limit
        required: false
      - schema:
          default: desc
          type: string
          enum:
          - asc
          - desc
          - ASC
          - DESC
        in: query
        name: order
        required: false
      - schema:
          default: materialHeaderId
          type: string
          enum:
          - materialHeaderId
          - rawMaterialId
          - percentage
          - hierarchy
          - position
          - createdAt
          - updatedAt
        in: query
        name: sort
        required: false
      - schema:
          type: string
        in: query
        name: materialHeaderId
        required: false
      - schema:
          type: string
        in: query
        name: rawMaterialId
        required: false
      - schema:
          type: string
        in: query
        name: parentId
        required: false
      - schema:
          type: string
        in: query
        name: countriesOfOrigin
        required: false
      - schema:
          type: string
        in: query
        name: include
        required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        materialHeaderId:
                          type: string
                        rawMaterialId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        percentage:
                          anyOf:
                          - type: number
                          - type: 'null'
                        weights:
                          anyOf:
                          - type: number
                          - type: 'null'
                        weightUnit:
                          anyOf:
                          - type: string
                          - type: 'null'
                        parentId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        hierarchy:
                          anyOf:
                          - type: number
                          - type: 'null'
                        position:
                          anyOf:
                          - type: number
                          - type: 'null'
                        countriesOfOrigin:
                          anyOf:
                          - type: array
                            items:
                              type: string
                          - type: 'null'
                        createdAt:
                          type: string
                          format: date-time
                        createdByUserId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        createdByCompanyId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        updatedAt:
                          type: string
                          format: date-time
                        updatedByUserId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        updatedByCompanyId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        rawMaterial:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            description:
                              anyOf:
                              - type: string
                              - type: 'null'
                            category:
                              anyOf:
                              - type: string
                              - type: 'null'
                            isRecycled:
                              anyOf:
                              - type: boolean
                              - type: 'null'
                            isSynthetic:
                              anyOf:
                              - type: boolean
                              - type: 'null'
                          required:
                          - id
                          - name
                          - description
                          - category
                          - isRecycled
                          - isSynthetic
                          additionalProperties: false
                        countries:
                          type: array
                          items:
                            type: object
                            properties:
                              countryCode:
                                type: string
                              countryName:
                                type: string
                              countryNameLocale:
                                type: string
                              region:
                                type: string
                              currencyCode:
                                anyOf:
                                - type: string
                                - type: 'null'
                              currencyName:
                                anyOf:
                                - type: string
                                - type: 'null'
                            required:
                            - countryCode
                            - countryName
                            - countryNameLocale
                            - region
                            - currencyCode
                            - currencyName
                            additionalProperties: false
                      required:
                      - id
                      - materialHeaderId
                      - rawMaterialId
                      - percentage
                      - weights
                      - weightUnit
                      - parentId
                      - hierarchy
                      - position
                      - countriesOfOrigin
                      - createdAt
                      - createdByUserId
                      - createdByCompanyId
                      - updatedAt
                      - updatedByUserId
                      - updatedByCompanyId
                      additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Get api material lines
      x-summary-source: derived
      operationId: getApiV2MaterialLines
      x-operation-id-source: derived
  /api/v2/material-lines/delete:
    post:
      tags:
      - Product / Material Lines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                materialLineIds:
                  minItems: 1
                  maxItems: 100
                  type: array
                  items:
                    type: string
                    minLength: 1
                styleId:
                  type: string
                  minLength: 1
              required:
              - materialLineIds
              - styleId
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: object
                    properties:
                      deletedLines:
                        description: IDs of successfully deleted material lines
                        type: array
                        items:
                          type: string
                      duplicatedHeaders:
                        description: Details of headers that were duplicated for child entities
                        type: array
                        items:
                          type: object
                          properties:
                            originalHeaderId:
                              type: string
                            newHeaderId:
                              type: string
                            forEntityId:
                              type: string
                            entityType:
                              type: string
                              enum:
                              - style
                              - variant
                              - sku
                          required:
                          - originalHeaderId
                          - newHeaderId
                          - forEntityId
                          - entityType
                          additionalProperties: false
                      orphanedHeaders:
                        description: IDs of headers that were cleaned up
                        type: array
                        items:
                          type: string
                      errors:
                        description: Errors encountered during deletion process
                        type: array
                        items:
                          type: object
                          properties:
                            materialLineId:
                              type: string
                            message:
                              type: string
                          required:
                          - materialLineId
                          - message
                          additionalProperties: false
                    required:
                    - deletedLines
                    - duplicatedHeaders
                    - orphanedHeaders
                    - errors
                    additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Create api material lines delete
      x-summary-source: derived
      operationId: postApiV2MaterialLinesDelete
      x-operation-id-source: derived
  /api/v2/material-lines/{id}:
    put:
      tags:
      - Product / Material Lines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                styleId:
                  type: string
                  minLength: 1
                materialHeaderId:
                  type: string
                  minLength: 1
                parentId:
                  anyOf:
                  - type: string
                  - type: 'null'
                percentage:
                  type: number
                  minimum: 0
                  maximum: 100
                rawMaterialId:
                  type: string
                  minLength: 1
                weights:
                  type: number
                  minimum: 0
                weightUnit:
                  type: string
                  maxLength: 255
                level:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                position:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                countriesOfOrigin:
                  type: array
                  items:
                    type: string
                    minLength: 2
                    maxLength: 2
              required:
              - styleId
              - materialHeaderId
              - percentage
              - rawMaterialId
      parameters:
      - schema:
          type: string
          minLength: 1
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      materialHeaderId:
                        type: string
                      rawMaterialId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      percentage:
                        anyOf:
                        - type: number
                        - type: 'null'
                      weights:
                        anyOf:
                        - type: number
                        - type: 'null'
                      weightUnit:
                        anyOf:
                        - type: string
                        - type: 'null'
                      parentId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      hierarchy:
                        anyOf:
                        - type: number
                        - type: 'null'
                      position:
                        anyOf:
                        - type: number
                        - type: 'null'
                      countriesOfOrigin:
                        anyOf:
                        - type: array
                          items:
                            type: string
                        - type: 'null'
                      createdAt:
                        type: string
                        format: date-time
                      createdByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      createdByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedAt:
                        type: string
                        format: date-time
                      updatedByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                    required:
                    - id
                    - materialHeaderId
                    - rawMaterialId
                    - percentage
                    - weights
                    - weightUnit
                    - parentId
                    - hierarchy
                    - position
                    - countriesOfOrigin
                    - createdAt
                    - createdByUserId
                    - createdByCompanyId
                    - updatedAt
                    - updatedByUserId
                    - updatedByCompanyId
                    additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Replace api material lines by id
      x-summary-source: derived
      operationId: putApiV2MaterialLinesById
      x-operation-id-source: derived