Miscellaneous

The Miscellaneous endpoints allows you to get general information about the status of the API and the PIM installation as well as the ability to manage objects which are shared between entities in Struct PIM.

Get currently running PIM Version

get

Authorizations

ApiKey

AuthorizationstringRequired

Responses

200

OK

application/json

PIM version

VersionNumberstring · nullableOptional

Version number

get

/v1/Version

HTTPcURLJavaScriptPython

GET /v1/Version HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "VersionNumber": "text"
}

Get an indication if the API is alive

get

Returns "Is alive", if API is running correctly

Authorizations

ApiKey

AuthorizationstringRequired

Responses

200

OK

application/json

Heartbeat

Messagestring · nullableOptional

Message

get

/v1/Heartbeat

HTTPcURLJavaScriptPython

GET /v1/Heartbeat HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Message": "text"
}

Get all archive reasons

get

#Available from v.3.3.0

Authorizations

ApiKey

AuthorizationstringRequired

Responses

200

OK

application/json

An archive reason defines a reason that can be chosen when archiving products or variants in the system

Uidstring · uuidOptional

Unique id of archive reason

Namestring · nullableOptional

Presented name of archive reason

get

/v1/misc/archivereasons

HTTPcURLJavaScriptPython

GET /v1/misc/archivereasons HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "Uid": "a65755a7-9da5-4539-9568-89f3b457fd50",
    "Name": "Outdated"
  },
  {
    "Uid": "34462705-4ef3-4619-866c-e2eaaadcbe89",
    "Name": "Irrellevant"
  }
]

Create new archive reason

post

#Available from v.3.3.0

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

An archive reason defines a reason that can be chosen when archiving products or variants in the system

Uidstring · uuidOptional

Unique id of archive reason

Namestring · nullableOptional

Presented name of archive reason

Responses

200

OK

application/json

An archive reason defines a reason that can be chosen when archiving products or variants in the system

Uidstring · uuidOptional

Unique id of archive reason

Namestring · nullableOptional

Presented name of archive reason

post

/v1/misc/archivereasons

HTTPcURLJavaScriptPython

POST /v1/misc/archivereasons HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "Uid": "efb95e0a-e6b8-4a94-be1e-69b4014d99d1",
  "Name": "Outdated"
}

200

OK

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text"
}

Update archive reason

put

#Available from v.3.3.0

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

An archive reason defines a reason that can be chosen when archiving products or variants in the system

Uidstring · uuidOptional

Unique id of archive reason

Namestring · nullableOptional

Presented name of archive reason

Responses

200

OK

application/json

An archive reason defines a reason that can be chosen when archiving products or variants in the system

Uidstring · uuidOptional

Unique id of archive reason

Namestring · nullableOptional

Presented name of archive reason

put

/v1/misc/archivereasons

HTTPcURLJavaScriptPython

PUT /v1/misc/archivereasons HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "Uid": "02c4b72e-f316-4130-8129-c91b4ccd96f2",
  "Name": "Outdated"
}

200

OK

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text"
}

Get an archive reason

get

#Available from v.3.3.0

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

uidstring · uuidRequired

Id of archive reason

Responses

200

OK

application/json

An archive reason defines a reason that can be chosen when archiving products or variants in the system

Uidstring · uuidOptional

Unique id of archive reason

Namestring · nullableOptional

Presented name of archive reason

get

/v1/misc/archivereasons/{uid}

HTTPcURLJavaScriptPython

GET /v1/misc/archivereasons/{uid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Uid": "82fe23b8-b67b-42b8-84b3-e2441a8beb5b",
  "Name": "Outdated"
}

Delete an archive reason

delete

#Available from v.3.3.0

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

uidstring · uuidRequired

Id of archive reason

Responses

200

OK

No content

delete

/v1/misc/archivereasons/{uid}

HTTPcURLJavaScriptPython

DELETE /v1/misc/archivereasons/{uid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

No content

Get model definitions for products, variants, categories and global lists

get

#Available from v.3.2.0 Get complete the model descriptions for products, variants and categories, usable for migration tools, Model classes scaffolding etc.

Authorizations

ApiKey

AuthorizationstringRequired

Responses

200

OK

application/json

Model structure

get

/v1/misc/models

HTTPcURLJavaScriptPython

GET /v1/misc/models HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "ProductModels": [
    {
      "Alias": "text",
      "Properties": [
        {
          "Alias": "text",
          "DataType": "text",
          "Localized": true,
          "IsMultiValue": true,
          "DimensionSpecific": true,
          "ReferencedAttribute": "text",
          "Properties": [
            "[Circular Reference]"
          ],
          "Name": "text",
          "Description": "text"
        }
      ]
    }
  ],
  "VariantModels": [
    {
      "Alias": "text",
      "Properties": [
        {
          "Alias": "text",
          "DataType": "text",
          "Localized": true,
          "IsMultiValue": true,
          "DimensionSpecific": true,
          "ReferencedAttribute": "text",
          "Properties": [
            "[Circular Reference]"
          ],
          "Name": "text",
          "Description": "text"
        }
      ]
    }
  ],
  "CategoryModels": [
    {
      "Alias": "text",
      "Properties": [
        {
          "Alias": "text",
          "DataType": "text",
          "Localized": true,
          "IsMultiValue": true,
          "DimensionSpecific": true,
          "ReferencedAttribute": "text",
          "Properties": [
            "[Circular Reference]"
          ],
          "Name": "text",
          "Description": "text"
        }
      ]
    }
  ],
  "VariantGroupModels": [
    {
      "Alias": "text",
      "Properties": [
        {
          "Alias": "text",
          "DataType": "text",
          "Localized": true,
          "IsMultiValue": true,
          "DimensionSpecific": true,
          "ReferencedAttribute": "text",
          "Properties": [
            "[Circular Reference]"
          ],
          "Name": "text",
          "Description": "text"
        }
      ]
    }
  ],
  "GlobalListModels": [
    {
      "Alias": "text",
      "DataType": "text",
      "Localized": true,
      "IsMultiValue": true,
      "DimensionSpecific": true,
      "ReferencedAttribute": "text",
      "Properties": [
        {
          "Alias": "text",
          "DataType": "text",
          "Localized": true,
          "IsMultiValue": true,
          "DimensionSpecific": true,
          "ReferencedAttribute": "text",
          "Properties": [
            "[Circular Reference]"
          ],
          "Name": "text",
          "Description": "text"
        }
      ],
      "Name": "text",
      "Description": "text"
    }
  ],
  "CategoryAttributeModels": [
    {
      "Alias": "text",
      "DataType": "text",
      "Localized": true,
      "IsMultiValue": true,
      "DimensionSpecific": true,
      "ReferencedAttribute": "text",
      "Properties": [
        {
          "Alias": "text",
          "DataType": "text",
          "Localized": true,
          "IsMultiValue": true,
          "DimensionSpecific": true,
          "ReferencedAttribute": "text",
          "Properties": [
            "[Circular Reference]"
          ],
          "Name": "text",
          "Description": "text"
        }
      ],
      "Name": "text",
      "Description": "text"
    }
  ]
}