{
  "openapi" : "3.1.0",
  "info" : {
    "title" : "Manage OXOMI Content",
    "version" : "1.0.0",
    "description" : "Provides services to import and delete catalogs and videos."
  },
  "paths" : {
    "/import/catalog" : {
      "post" : {
        "operationId" : "post-import-catalog",
        "summary" : "Import Catalog",
        "description" : "Imports the specified catalog.",
        "parameters" : [ {
          "name" : "filename",
          "in" : "query",
          "required" : true,
          "description" : "Name of the file affected by the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "catalog.pdf"
        }, {
          "name" : "forwarding",
          "in" : "query",
          "required" : true,
          "description" : "Indicates whether the content should be shared with partners.",
          "schema" : {
            "type" : "string"
          },
          "example" : "false"
        }, {
          "name" : "password",
          "in" : "query",
          "required" : true,
          "description" : "The user's password.",
          "schema" : {
            "type" : "string"
          },
          "example" : "****************"
        }, {
          "name" : "targetLevel",
          "in" : "query",
          "required" : true,
          "description" : "Defines the kba:HFS5T for which the content should be visible.",
          "schema" : {
            "type" : "string"
          },
          "example" : "WHOLESALE"
        }, {
          "name" : "type",
          "in" : "query",
          "required" : true,
          "description" : "Defines the content type. All possible types and the corresponding codes can be found at lookupTable:catalog-types.",
          "schema" : {
            "type" : "string"
          },
          "example" : "flyer"
        }, {
          "name" : "user",
          "in" : "query",
          "required" : true,
          "description" : "Username of the OXOMI user to use for the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "john.doe"
        }, {
          "name" : "additionalLanguages",
          "in" : "query",
          "required" : false,
          "description" : "Defines additional languages for which this content is available. This parameter could be provided multiple times, for each language one parameter-value-pair is necessary. All available languages and their abbreviations can be found at lookupTable:active-languages.",
          "schema" : {
            "type" : "string"
          },
          "example" : "en"
        }, {
          "name" : "additionalSearchTerms",
          "in" : "query",
          "required" : false,
          "description" : "Defines additional search terms for this document. This parameter could be provided multiple times, for each term one parameter-value-pair is necessary.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Industrie Highlights 2023"
        }, {
          "name" : "brand",
          "in" : "query",
          "required" : false,
          "description" : "Defines a brand for the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "BRAND_ID"
        }, {
          "name" : "category",
          "in" : "query",
          "required" : false,
          "description" : "Defines a help:categories,\"category\" for the content. The category must already exist in OXOMI categories.",
          "schema" : {
            "type" : "string"
          },
          "example" : "CATEGORY_ID"
        }, {
          "name" : "code",
          "in" : "query",
          "required" : false,
          "description" : "Defines a code which can be used to specifically address the element.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Industry_Highlights_23"
        }, {
          "name" : "countries",
          "in" : "query",
          "required" : false,
          "description" : "Defines for which countries this content is available. The value is a country code. This parameter could be provided multiple times, for each country one parameter-value-pair is necessary. All available countries and their abbreviations can be found at lookupTable:active-countries.",
          "schema" : {
            "type" : "string"
          },
          "example" : "de"
        }, {
          "name" : "description",
          "in" : "query",
          "required" : false,
          "description" : "Defines a text that is used as a description of the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "This is a description text."
        }, {
          "name" : "editorMail",
          "in" : "query",
          "required" : false,
          "description" : "This email address gets notified when new comments are added in this document in your own portals.",
          "schema" : {
            "type" : "string"
          },
          "example" : "editor@scireum.de"
        }, {
          "name" : "fileHash",
          "in" : "query",
          "required" : false,
          "description" : "Defines the MD5 hash of the content file. If provided, OXOMI checks whether the file is different from the one currently stored based on this value.",
          "schema" : {
            "type" : "string"
          },
          "example" : "d0765f518ff0cab426dbbd6d467c9967"
        }, {
          "name" : "id",
          "in" : "query",
          "required" : false,
          "description" : "Defines the OXOMI ID of an already existing content whose metadata should be updated. The \"id\" is also presented as \"entityId\" in the server response after a successful operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "1193"
        }, {
          "name" : "internalName",
          "in" : "query",
          "required" : false,
          "description" : "Use this parameter to define the internal name. The parameter \"publicName\" defines the name visible to portals and integrations.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Industry Highlights 01 2023"
        }, {
          "name" : "language",
          "in" : "query",
          "required" : false,
          "description" : "Defines for which language this content is available. The value is a language code. If not specified, the default language of the tenant is used. All available languages and their abbreviations can be found at lookupTable:active-languages.",
          "schema" : {
            "type" : "string"
          },
          "example" : "de"
        }, {
          "name" : "pageOffset",
          "in" : "query",
          "required" : false,
          "description" : "If the page of the document, on which the page number \"1\" is printed, is on the third page of the document, the page offset is 2.",
          "schema" : {
            "type" : "string"
          },
          "example" : "2"
        }, {
          "name" : "partnerRole",
          "in" : "query",
          "required" : false,
          "description" : "Defines a partner role for the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "PARTNER_ROLE_ID"
        }, {
          "name" : "portalRole-*",
          "in" : "query",
          "required" : false,
          "description" : "Defines the portal role via ID that should be assigned to the content in the specified portal (via ID).",
          "schema" : {
            "type" : "string"
          },
          "example" : "ABC123"
        }, {
          "name" : "printable",
          "in" : "query",
          "required" : false,
          "description" : "Defines if the document has a print version available.",
          "schema" : {
            "type" : "string"
          },
          "example" : "true"
        }, {
          "name" : "publicName",
          "in" : "query",
          "required" : false,
          "description" : "Defines the name that will be displayed for the content if there is no translation of the name into a certain language.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Industry Highlights 2023"
        }, {
          "name" : "publicName-**",
          "in" : "query",
          "required" : false,
          "description" : "Defines the name that will be displayed in OXOMI in a specific language for the content. The suffix \"**\" in the parameter stands for a language abbreviation that defines the target language. For example \"publicName-de\". All available languages and their abbreviations can be found at lookupTable:active-languages.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Industrie Highlights 2023"
        }, {
          "name" : "series",
          "in" : "query",
          "required" : false,
          "description" : "Defines a series for the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "SERIES_ID"
        }, {
          "name" : "surcharge",
          "in" : "query",
          "required" : false,
          "description" : "Defines additional information about the document.",
          "schema" : {
            "type" : "string"
          },
          "example" : "This is an additional description or hint for the document."
        }, {
          "name" : "tags",
          "in" : "query",
          "required" : false,
          "description" : "Defines tags that will be added to this content. This parameter could be provided multiple times, for each tag one parameter-value-pair is necessary.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Exhibition_2023"
        }, {
          "name" : "updateInfo",
          "in" : "query",
          "required" : false,
          "description" : "Defines whether the attached metadata should overwrite the existing one if the content already exists. If this parameter is not provided the existing metadata will not be overwritten. Possible values are: true/false.",
          "schema" : {
            "type" : "string"
          },
          "example" : "true"
        }, {
          "name" : "validDateFrom",
          "in" : "query",
          "required" : false,
          "description" : "Defines a date from when the content is visible. Format: DD.MM.YYYY",
          "schema" : {
            "type" : "string"
          },
          "example" : "01.01.2019"
        }, {
          "name" : "validDateUntil",
          "in" : "query",
          "required" : false,
          "description" : "Defines a date until when the content is visible. Format: DD.MM.YYYY",
          "schema" : {
            "type" : "string"
          },
          "example" : "31.12.2019"
        } ],
        "responses" : {
          "200" : {
            "description" : "Your changes have been saved. Triggered when an update took place, which requires updateInfo to be true.",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : true,
                      "error" : false,
                      "message" : "Your changes have been saved.",
                      "entityId" : "1200"
                    }
                  }
                }
              }
            }
          },
          "400" : {
            "description" : "Missing parameter or malformed request",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : false,
                      "error" : true,
                      "message" : "The parameter {missingParameter} must be filled."
                    }
                  }
                }
              }
            }
          },
          "401" : {
            "description" : "Authentication required but none provided",
            "content" : {
              "application/json" : { }
            }
          },
          "403" : {
            "description" : "Invalid authentication or missing permission",
            "content" : {
              "application/json" : { }
            }
          },
          "404" : {
            "description" : "Resource not found",
            "content" : {
              "application/json" : { }
            }
          },
          "405" : {
            "description" : "Incorrect request method, e.g. GET instead of POST",
            "content" : {
              "application/json" : { }
            }
          },
          "500" : {
            "description" : "Unexpected server-side error",
            "content" : {
              "application/json" : { }
            }
          }
        }
      }
    },
    "/import/catalog/delete" : {
      "get" : {
        "operationId" : "get-import-catalog-delete",
        "summary" : "Delete Catalog",
        "description" : "Deletes the specified catalog.",
        "parameters" : [ {
          "name" : "filename",
          "in" : "query",
          "required" : true,
          "description" : "Name of the file affected by the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "catalog.pdf"
        }, {
          "name" : "password",
          "in" : "query",
          "required" : true,
          "description" : "The user's password.",
          "schema" : {
            "type" : "string"
          },
          "example" : "****************"
        }, {
          "name" : "user",
          "in" : "query",
          "required" : true,
          "description" : "Username of the OXOMI user to use for the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "john.doe"
        }, {
          "name" : "deleteOld",
          "in" : "query",
          "required" : false,
          "description" : "Determines if the content should be deleted (true) or archived (false).",
          "schema" : {
            "type" : "string"
          },
          "example" : "false"
        } ],
        "responses" : {
          "200" : {
            "description" : "Successful response",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : true,
                      "error" : false,
                      "message" : "The object was deleted successfully.",
                      "entityId" : "1191"
                    }
                  }
                }
              }
            }
          },
          "400" : {
            "description" : "Missing parameter or malformed request",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : false,
                      "error" : true,
                      "message" : "The parameter {missingParameter} must be filled."
                    }
                  }
                }
              }
            }
          },
          "401" : {
            "description" : "Authentication required but none provided",
            "content" : {
              "application/json" : { }
            }
          },
          "403" : {
            "description" : "Invalid authentication or missing permission",
            "content" : {
              "application/json" : { }
            }
          },
          "404" : {
            "description" : "Resource not found",
            "content" : {
              "application/json" : { }
            }
          },
          "405" : {
            "description" : "Incorrect request method, e.g. GET instead of POST",
            "content" : {
              "application/json" : { }
            }
          },
          "500" : {
            "description" : "Unexpected server-side error",
            "content" : {
              "application/json" : { }
            }
          }
        }
      }
    },
    "/import/video" : {
      "post" : {
        "operationId" : "post-import-video",
        "summary" : "Import Video",
        "description" : "Imports the specified Video.",
        "parameters" : [ {
          "name" : "filename",
          "in" : "query",
          "required" : true,
          "description" : "Name of the file affected by the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "video.mp4"
        }, {
          "name" : "forwarding",
          "in" : "query",
          "required" : true,
          "description" : "Indicates whether the content should be shared with partners.",
          "schema" : {
            "type" : "string"
          },
          "example" : "false"
        }, {
          "name" : "password",
          "in" : "query",
          "required" : true,
          "description" : "The user's password.",
          "schema" : {
            "type" : "string"
          },
          "example" : "****************"
        }, {
          "name" : "targetLevel",
          "in" : "query",
          "required" : true,
          "description" : "Defines the kba:HFS5T for which the content should be visible.",
          "schema" : {
            "type" : "string"
          },
          "example" : "WHOLESALE"
        }, {
          "name" : "type",
          "in" : "query",
          "required" : true,
          "description" : "Defines the content type. All possible types and the corresponding codes can be found at lookupTable:video-types.",
          "schema" : {
            "type" : "string"
          },
          "example" : "usage"
        }, {
          "name" : "user",
          "in" : "query",
          "required" : true,
          "description" : "Username of the OXOMI user to use for the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "john.doe"
        }, {
          "name" : "additionalLanguages",
          "in" : "query",
          "required" : false,
          "description" : "Defines additional languages for which this content is available. This parameter could be provided multiple times, for each language one parameter-value-pair is necessary. All available languages and their abbreviations can be found at lookupTable:active-languages.",
          "schema" : {
            "type" : "string"
          },
          "example" : "en"
        }, {
          "name" : "brand",
          "in" : "query",
          "required" : false,
          "description" : "Defines a brand for the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "BRAND_ID"
        }, {
          "name" : "category",
          "in" : "query",
          "required" : false,
          "description" : "Defines a help:categories,\"category\" for the content. The category must already exist in OXOMI categories.",
          "schema" : {
            "type" : "string"
          },
          "example" : "CATEGORY_ID"
        }, {
          "name" : "code",
          "in" : "query",
          "required" : false,
          "description" : "Defines a code which can be used to specifically address the element.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Tool_Usage_2023"
        }, {
          "name" : "countries",
          "in" : "query",
          "required" : false,
          "description" : "Defines for which countries this content is available. The value is a country code. This parameter could be provided multiple times, for each country one parameter-value-pair is necessary. All available countries and their abbreviations can be found at lookupTable:active-countries.",
          "schema" : {
            "type" : "string"
          },
          "example" : "de"
        }, {
          "name" : "description",
          "in" : "query",
          "required" : false,
          "description" : "Defines a text that is used as a description of the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "This is a description text."
        }, {
          "name" : "fileHash",
          "in" : "query",
          "required" : false,
          "description" : "Defines the MD5 hash of the content file. If provided, OXOMI checks whether the file is different from the one currently stored based on this value.",
          "schema" : {
            "type" : "string"
          },
          "example" : "d0765f518ff0cab426dbbd6d467c9967"
        }, {
          "name" : "id",
          "in" : "query",
          "required" : false,
          "description" : "Defines the OXOMI ID of an already existing content whose metadata should be updated. The \"id\" is also presented as \"entityId\" in the server response after a successful operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "1193"
        }, {
          "name" : "internalName",
          "in" : "query",
          "required" : false,
          "description" : "Use this parameter to define the internal name. The parameter \"publicName\" defines the name visible to portals and integrations.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Tool Usage Demonstration 01 2023"
        }, {
          "name" : "language",
          "in" : "query",
          "required" : false,
          "description" : "Defines for which language this content is available. The value is a language code. If not specified, the default language of the tenant is used. All available languages and their abbreviations can be found at lookupTable:active-languages.",
          "schema" : {
            "type" : "string"
          },
          "example" : "de"
        }, {
          "name" : "partnerRole",
          "in" : "query",
          "required" : false,
          "description" : "Defines a partner role for the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "PARTNER_ROLE_ID"
        }, {
          "name" : "publicName",
          "in" : "query",
          "required" : false,
          "description" : "Defines the name that will be displayed for the content if there is no translation of the name into a certain language.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Tool Usage Demonstration"
        }, {
          "name" : "publicName-**",
          "in" : "query",
          "required" : false,
          "description" : "Defines the name that will be displayed in OXOMI in a specific language for the content. The suffix \"**\" in the parameter stands for a language abbreviation that defines the target language. For example \"publicName-de\". All available languages and their abbreviations can be found at lookupTable:active-languages",
          "schema" : {
            "type" : "string"
          },
          "example" : "Demonstration der Werkzeugverwendung"
        }, {
          "name" : "series",
          "in" : "query",
          "required" : false,
          "description" : "Defines a series for the content.",
          "schema" : {
            "type" : "string"
          },
          "example" : "SERIES_ID"
        }, {
          "name" : "tags",
          "in" : "query",
          "required" : false,
          "description" : "Defines tags that will be added to this content. This parameter could be provided multiple times, for each tag one parameter-value-pair is necessary.",
          "schema" : {
            "type" : "string"
          },
          "example" : "Exhibition_2023"
        }, {
          "name" : "updateInfo",
          "in" : "query",
          "required" : false,
          "description" : "Defines whether the attached metadata should overwrite the existing one if the content already exists. If this parameter is not provided the existing metadata will not be overwritten. Possible values are: true/false.",
          "schema" : {
            "type" : "string"
          },
          "example" : "true"
        }, {
          "name" : "validDateFrom",
          "in" : "query",
          "required" : false,
          "description" : "Defines a date from when the content is visible. Format: DD.MM.YYYY",
          "schema" : {
            "type" : "string"
          },
          "example" : "01.01.2019"
        }, {
          "name" : "validDateUntil",
          "in" : "query",
          "required" : false,
          "description" : "Defines a date until when the content is visible. Format: DD.MM.YYYY",
          "schema" : {
            "type" : "string"
          },
          "example" : "31.12.2019"
        } ],
        "responses" : {
          "200" : {
            "description" : "Your changes have been saved. Triggered when an update took place, which requires updateInfo to be true.",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : true,
                      "error" : false,
                      "message" : "Your changes have been saved.",
                      "entityId" : "1200"
                    }
                  }
                }
              }
            }
          },
          "400" : {
            "description" : "Missing parameter or malformed request",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : false,
                      "error" : true,
                      "message" : "The parameter {missingParameter} must be filled."
                    }
                  }
                }
              }
            }
          },
          "401" : {
            "description" : "Authentication required but none provided",
            "content" : {
              "application/json" : { }
            }
          },
          "403" : {
            "description" : "Invalid authentication or missing permission",
            "content" : {
              "application/json" : { }
            }
          },
          "404" : {
            "description" : "Resource not found",
            "content" : {
              "application/json" : { }
            }
          },
          "405" : {
            "description" : "Incorrect request method, e.g. GET instead of POST",
            "content" : {
              "application/json" : { }
            }
          },
          "500" : {
            "description" : "Unexpected server-side error",
            "content" : {
              "application/json" : { }
            }
          }
        }
      }
    },
    "/import/video/delete" : {
      "get" : {
        "operationId" : "get-import-video-delete",
        "summary" : "Delete Video",
        "description" : "Deletes the specified Video.",
        "parameters" : [ {
          "name" : "filename",
          "in" : "query",
          "required" : true,
          "description" : "Name of the file affected by the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "video.mp4"
        }, {
          "name" : "password",
          "in" : "query",
          "required" : true,
          "description" : "The user's password.",
          "schema" : {
            "type" : "string"
          },
          "example" : "****************"
        }, {
          "name" : "user",
          "in" : "query",
          "required" : true,
          "description" : "Username of the OXOMI user to use for the operation.",
          "schema" : {
            "type" : "string"
          },
          "example" : "john.doe"
        }, {
          "name" : "deleteOld",
          "in" : "query",
          "required" : false,
          "description" : "Determines if the content should be deleted (true) or archived (false).",
          "schema" : {
            "type" : "string"
          },
          "example" : "false"
        } ],
        "responses" : {
          "200" : {
            "description" : "Successful response",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : true,
                      "error" : false,
                      "message" : "The object was deleted successfully.",
                      "entityId" : "1191"
                    }
                  }
                }
              }
            }
          },
          "400" : {
            "description" : "Missing parameter or malformed request",
            "content" : {
              "application/json" : {
                "examples" : {
                  "example1" : {
                    "value" : {
                      "success" : false,
                      "error" : true,
                      "message" : "The parameter {missingParameter} must be filled."
                    }
                  }
                }
              }
            }
          },
          "401" : {
            "description" : "Authentication required but none provided",
            "content" : {
              "application/json" : { }
            }
          },
          "403" : {
            "description" : "Invalid authentication or missing permission",
            "content" : {
              "application/json" : { }
            }
          },
          "404" : {
            "description" : "Resource not found",
            "content" : {
              "application/json" : { }
            }
          },
          "405" : {
            "description" : "Incorrect request method, e.g. GET instead of POST",
            "content" : {
              "application/json" : { }
            }
          },
          "500" : {
            "description" : "Unexpected server-side error",
            "content" : {
              "application/json" : { }
            }
          }
        }
      }
    }
  }
}