# Create Item

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /items:
    post:
      summary: Create Item
      deprecated: false
      description: ''
      operationId: PostItemList
      tags:
        - API Reference/Items
        - Items
      parameters: []
      requestBody:
        content:
          application/json:
            schema: &ref_0
              $ref: '#/components/schemas/Item'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: *ref_0
                required:
                  - data
                x-apidog-orders:
                  - data
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: API Reference/Items
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1200447/apis/api-38447068-run
components:
  schemas:
    Item:
      type: object
      properties:
        id:
          type: string
          title: ''
          description: Unique identifier in the Makini dataset.
          readOnly: true
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        code:
          type: string
          title: ''
          description: A unique identifier code for this entity.
          examples:
            - entity-code-1
        _source:
          type: string
          title: ''
          description: >-
            The originating source table/endpoint or derivation name for this
            record.
          readOnly: true
          examples:
            - EndpointName
            - TableName
            - derived
        _idValue:
          type: string
          title: ''
          description: The original identifier value from the source system.
          readOnly: true
          examples:
            - '1234'
            - '000000001'
            - ABCID123
        _displayValue:
          type: string
          description: A human-readable display label derived from the source record.
          readOnly: true
          title: ''
        _updatedAt:
          type: string
          description: >-
            Timestamp indicating when this record was last updated in the source
            system.
          readOnly: true
          format: date-time
        _createdAt:
          type: string
          description: >-
            Timestamp indicating when this record was created in the source
            system.
          format: date-time
          readOnly: true
        _deletedAt:
          type: string
          description: >-
            Timestamp indicating when this record was deleted/soft-deleted in
            the source system; null if not deleted.
          format: date-time
          readOnly: true
          nullable: true
        _implements:
          type: array
          description: A list of interface/schema identifiers that this record implements.
          items:
            type: string
          readOnly: true
        name:
          type: string
          description: The name of the entity.
          examples:
            - Entity Name
        description:
          type: string
          description: An optional description providing more details about the entity.
          examples:
            - Entity Description
          nullable: true
        brandName:
          type: string
        marketName:
          type: string
        parent:
          anyOf:
            - &ref_1
              $ref: '#/components/schemas/Relation'
            - *ref_0
            - type: 'null'
        uom:
          anyOf:
            - *ref_1
            - &ref_2
              $ref: '#/components/schemas/Unit'
            - type: 'null'
        manufacturer:
          anyOf:
            - *ref_1
            - $ref: '#/components/schemas/Partner'
            - type: 'null'
      required:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - brandName
        - marketName
      x-apidog-orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - brandName
        - marketName
        - parent
        - uom
        - manufacturer
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Partner:
      type: object
      properties:
        id:
          type: string
          title: ''
          description: Unique identifier in the Makini dataset.
          readOnly: true
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        code:
          type: string
          title: ''
          description: A unique identifier code for this entity.
          examples:
            - entity-code-1
        _source:
          type: string
          title: ''
          description: >-
            The originating source table/endpoint or derivation name for this
            record.
          readOnly: true
          examples:
            - EndpointName
            - TableName
            - derived
        _idValue:
          type: string
          title: ''
          description: The original identifier value from the source system.
          readOnly: true
          examples:
            - '1234'
            - '000000001'
            - ABCID123
        _displayValue:
          type: string
          description: A human-readable display label derived from the source record.
          readOnly: true
          title: ''
        _updatedAt:
          type: string
          description: >-
            Timestamp indicating when this record was last updated in the source
            system.
          readOnly: true
          format: date-time
        _createdAt:
          type: string
          description: >-
            Timestamp indicating when this record was created in the source
            system.
          format: date-time
          readOnly: true
        _deletedAt:
          type: string
          description: >-
            Timestamp indicating when this record was deleted/soft-deleted in
            the source system; null if not deleted.
          format: date-time
          readOnly: true
          nullable: true
        _implements:
          type: array
          description: A list of interface/schema identifiers that this record implements.
          items:
            type: string
          readOnly: true
        name:
          type: string
          description: The name of the entity.
          examples:
            - Entity Name
        description:
          type: string
          description: An optional description providing more details about the entity.
          examples:
            - Entity Description
          nullable: true
        legalName:
          type: string
          description: Official registered legal name of the partner entity
          nullable: true
        currency:
          anyOf:
            - *ref_1
            - $ref: '#/components/schemas/Currency'
            - type: 'null'
          description: >-
            Currency associated with the partner entity/relationship; may
            reference a currency definition or be null
        isActive:
          type: boolean
          description: Flag indicating if the partnership is currently active
        partnerSinceDate:
          type: string
          format: date
          description: Date when the partnership began
          nullable: true
        partnerEndDate:
          type: string
          format: date
          description: Date when the partnership ended or is scheduled to end
          nullable: true
      required:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
      x-apidog-orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - legalName
        - currency
        - isActive
        - partnerSinceDate
        - partnerEndDate
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Currency:
      type: object
      properties:
        id:
          type: string
          title: ''
          description: Unique identifier in the Makini dataset.
          readOnly: true
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        code:
          type: string
          title: ''
          description: A unique identifier code for this entity.
          examples:
            - entity-code-1
        _source:
          type: string
          title: ''
          description: >-
            The originating source table/endpoint or derivation name for this
            record.
          readOnly: true
          examples:
            - EndpointName
            - TableName
            - derived
        _idValue:
          type: string
          title: ''
          description: The original identifier value from the source system.
          readOnly: true
          examples:
            - '1234'
            - '000000001'
            - ABCID123
        _displayValue:
          type: string
          description: A human-readable display label derived from the source record.
          readOnly: true
          title: ''
        _updatedAt:
          type: string
          description: >-
            Timestamp indicating when this record was last updated in the source
            system.
          readOnly: true
          format: date-time
        _createdAt:
          type: string
          description: >-
            Timestamp indicating when this record was created in the source
            system.
          format: date-time
          readOnly: true
        _deletedAt:
          type: string
          description: >-
            Timestamp indicating when this record was deleted/soft-deleted in
            the source system; null if not deleted.
          format: date-time
          readOnly: true
          nullable: true
        _implements:
          type: array
          description: A list of interface/schema identifiers that this record implements.
          items:
            type: string
          readOnly: true
        name:
          type: string
          description: The name of the entity.
          examples:
            - Entity Name
        description:
          type: string
          description: An optional description providing more details about the entity.
          examples:
            - Entity Description
          nullable: true
        symbol:
          type: string
        decimalPlaces:
          type: integer
          default: 2
        isActive:
          type: boolean
      required:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - isActive
      x-apidog-orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - symbol
        - decimalPlaces
        - isActive
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Unit:
      type: object
      properties:
        id:
          type: string
          title: ''
          description: Unique identifier in the Makini dataset.
          readOnly: true
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        code:
          type: string
          title: ''
          description: A unique identifier code for this entity.
          examples:
            - entity-code-1
        _source:
          type: string
          title: ''
          description: >-
            The originating source table/endpoint or derivation name for this
            record.
          readOnly: true
          examples:
            - EndpointName
            - TableName
            - derived
        _idValue:
          type: string
          title: ''
          description: The original identifier value from the source system.
          readOnly: true
          examples:
            - '1234'
            - '000000001'
            - ABCID123
        _displayValue:
          type: string
          description: A human-readable display label derived from the source record.
          readOnly: true
          title: ''
        _updatedAt:
          type: string
          description: >-
            Timestamp indicating when this record was last updated in the source
            system.
          readOnly: true
          format: date-time
        _createdAt:
          type: string
          description: >-
            Timestamp indicating when this record was created in the source
            system.
          format: date-time
          readOnly: true
        _deletedAt:
          type: string
          description: >-
            Timestamp indicating when this record was deleted/soft-deleted in
            the source system; null if not deleted.
          format: date-time
          readOnly: true
          nullable: true
        _implements:
          type: array
          description: A list of interface/schema identifiers that this record implements.
          items:
            type: string
          readOnly: true
        name:
          type: string
          description: The name of the entity.
          examples:
            - Entity Name
        description:
          type: string
          description: An optional description providing more details about the entity.
          examples:
            - Entity Description
          nullable: true
        symbol:
          type: string
          description: Standard symbol or abbreviation for the unit
        dimension:
          type: string
          description: Physical dimension category (length, mass, time, volume, etc.)
        baseUnit:
          oneOf:
            - *ref_1
            - *ref_2
            - type: 'null'
        conversionFactor:
          type: number
          description: Factor to convert this unit to the base unit
          nullable: true
        conversionOffset:
          type: number
          description: Offset for conversion (used for temperature conversions)
          nullable: true
      required:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - dimension
      x-apidog-orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - symbol
        - dimension
        - baseUnit
        - conversionFactor
        - conversionOffset
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Relation:
      type: object
      properties:
        id:
          type: string
          description: Related entity Makini ID
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        _idValue:
          type: string
          examples:
            - '1234'
            - '000000001'
            - ABCID123
          description: Related entity source ID
        _displayValue:
          type: string
          description: Human-readable description
        rel:
          type: string
          readOnly: true
          examples:
            - endpoint
          description: Related endpoint
        href:
          type: string
          format: uri
          readOnly: true
          examples:
            - >-
              https://api.makini.io/v4/endpoints/12345678aaaaaa111111bbbbbb222222cccccc33
          description: Resource URI
      required:
        - id
        - _idValue
        - _displayValue
        - rel
        - href
      x-apidog-orders:
        - id
        - _idValue
        - _displayValue
        - rel
        - href
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    Connection Token:
      type: bearer
      scheme: bearer
    Account Credentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://
servers:
  - url: https://api.makini.io/v4
    description: Prod Env
security: []

```