solarwinds-itsm-api-definitions 0.2.5 → 0.2.19

data/lib/definitions/openapi.json

@@ -3,8 +3,8 @@
   "info": {
     "title": "SolarWinds Service Desk API",
     "description":
-      "All SolarWinds Service Desk API definitions\n# General Concepts\n## Service URL\nFor US based customers, please use `https://api.samanage.com`\n\n For European based customers, please use `https://apieu.samanage.com`\n\n## Formats\n\nYou can use XML or JSON format for your request.\n\nXML Example: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/vnd.samanage.v2.1+xml\" -X GET https://api.samanage.com/incidents.xml`\n\nJSON Example: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/vnd.samanage.v2.1+json\" -H \"Content-Type: application/json\" -X GET https://api.samanage.com/incidents.json`\n\nFor create and update, the provided data needs to be in the correct format.\n\nXML Example: `<incident> <field_to_update>content</field_to_update> </incident>`\n\nJSON Example: `{\"incident\": {\"field_to_update\": \"content\"}}`\n\nTo clear fields, use the following format:\n\nXML Example: `<incident> <field_to_update></field_to_update> </incident>`\n\nJSON Example: `{\"incident\": {\"field_to_update\": \"\"}}`\n\n## Authentication\nThe API authentication is token-based. Admins can generate a token directly from the user setup page.  The token is needed by the API developer to gain access to specific items in SolarWinds accessible only via the API. When an admin re-generates their token (via the user setup page), all previously generated tokens become invalid.\n\nThe tokens are relatively long strings that resemble the following: <div style=\"word-wrap: break-word;\"> AAAZWV0YXkubmF0YW4rNUBzYW1hbmFnZS5jb20hbGciOiJIUzUxMiJ9.eyJ1c2VyX2ljIjoxMjU2OTQzLCJnZW5lcmF0ZWRfYXQiOiIyMDE3LTA2LTA3IDA5OjE3OjI5In0.j_H15qzJJr9vXGAHCThLEOQrE9GGbjMxZJOs5zAf_iqaGqxlIOAmvPpBx0td_C3r7dliAfXXIgdqhZHVoK1KTwAzd1</div>\n\nIn order to supply the API token you should pass X-Samanage-Authorization header in the following format: “Bearer API_TOKEN_STRING”.\n\nThe API call resembles the following:\n\n`curl -H \"X-Samanage-Authorization: Bearer AAAZWV0YXkubmF0YW4rNUBzYW1hbmFnZS5jb20hbGciOiJIUzUxMiJ9.eyJ1c2VyX2ljIjoxMjU2OTQzLCJnZW5lcmF0ZWRfYXQiOiIyMDE3LTA2LTA3IDA5OjE3OjI5In0.j_H15qzJJr9vXGAHCThLEOQrE9GGbjMxZJOs5zAf_iqaGqxlIOAmvPpBx0td_C3r7dliAfXXIgdqhZHVoK1KTwAzd1\" -H \"Accept: application/vnd.samanage.v2.1+json\" https://api.samanage.com/hardwares.json`\n\nIf the authentication fails, a “401 Unauthorized” message will be returned.\n## Security\nSWSD uses a secured API channel. To connect to the regional API server, use the account admin users’ token information and connect using Token-based authentication. Requests should never be transferred in plain text over the wire. Instead, use SSL version 1.2 or higher (which can be accessed using https://) to ensure that all communication with the server is encrypted and secured.\n## Limitations\nTo ensure API performance and avoid denial of service, we employ API call limits based per minute as defined by the Service Desk plan of the endpoint user.\n\nPackages:\n\nAdvanced Plan - 1000 calls per minute\n\nPremier Plan - 1500 calls per minute\n## Versioning\nClients must provide the version number they are ready to work with in the “Accept” HTTP header. A valid \"Accept\" header should specify current content type and version number. For example, “application/vnd.samanage.v2.1+xml”.\n When no “Accept” header is specified, the API will default to version 2.1.\nIf you request an API version that is no longer supported, the API will respond with an HTTP status code of “406 – Not Acceptable”.\n\nExample: \n`curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/vnd.samanage.v2.1+json\" https://api.samanage.com/hardwares.json`\n## Version History\n* 1.0: Deprecated\n* 1.1: Changed structure of custom_fields_values\n* 1.2: Changed name of “incident_type” to “category” in Catalog items and Incidents\n* 1.3: Updates to incidents or comments will not send an email or a notification to the users. To enable this feature you must add add_callbacks=true to the url.\n* 2.1: Token based authentication\n## Pagination\nEvery response with a large data set will be paginated. The response will include the pagination data as headers and links (formatted as <url>; rel=”relative”). For example:\n\nX-Per-Page: 50\n\nX-Total-Count: 3099\n\nX-Total-Pages: 62\n\nLink: `<https://api.samanage.com/incidents.xml?page=1>`; rel=\"first\",\n\n`<https://api.samanage.com/incidents.xml?page=8>`; rel=\"prev\",\n\n`<https://api.samanage.com/incidents.xml?page=10>`; rel=\"next\",\n\n`<https://api.samanage.com/incidents.xml?page=62>`; rel=\"last\"\n\nYou can request a specific page by providing a “page” parameter. For example, to request the third page of the hardware list, you can use the following command: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" https://api.samanage.com/hardwares.json?page=3`\n\nTo control the number of rows returned, provide the per_page parameter. For example, to request 100 rows with each results page, you can use the following command: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" https://api.samanage.com/hardwares.json?per_page=100`\n## API Entry Point\n All communication with the API begins with a list of available services. Although it is possible to get directly to a specific service URL, we advise you begin with the api.xml entry point. This ensures your program will run seamlessly if changes are made to the underlying URLs for services in future versions of the API.\n\n**Request**\n\nGET api.samanage.com/api.json \n`curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/json\" -X GET https://api.samanage.com/api.json`\n\n**Response**\n\n`[{\"name\":\"Computers List\",\"href\":\"https://api.samanage.com/hardwares.json\"},`\n\n`{\"name\":\"Helpdesk Incidents List\",\"href\":\"https://api.samanage.com/incidents.json\"},`\n\n`{\"name\":\"Changes List\",\"href\":\"https://api.samanage.com/changes.json\"},`\n\n`...]`\n## Short / long layout\nFor all APIs, you can specify the layout (short / long). This affects the length of the returned records, and is relevant for changes, contracts, hardwares, incidents, other assets, problems, and solutions.\n\nTo use, add the parameter to the request: “?layout=short” or “?layout=long”. If not present, the default is “short”.\n## Searching\nYou can search for records by using query parameters on top of the base URL. For example, when requesting a list of hardwares, you may want to limit them to only those with a specific IP address. This could be accomplished with a request like -\n\n GET api.samanage.com/hardwares.xml?ip_address=123.456*\n\nHere, ip_address is a query parameter that implements a filter where the IP equals 123.456.xxx.xxx.\n\nOther examples: `https://api.samanage.com/other_assets.json?asset_id=XXXXXXXX`, `https://api.samanage.com/hardwares.json?asset_tag=XXXXXXXX`\n## Date formats\nThe following date formats are allowed as input when updating date fields:\n\n* January 21, 2015\n* January 21 2015\n* Jan 21, 2015\n* Jan 21 2015\n* 21/1/2015\n* 2015/1/21\n* 21-1-2015\n* 2015-1-21\n*21.1.2015 \n* 2015.1.21\n## Custom fields\nTo set custom fields, use the following data format:\n\n XML Example:\n\n`<incident><custom_fields_values>`\n\n`<custom_fields_value><name>field name</name><value>content</value></custom_fields_value>`\n\n`</custom_fields_values></incident>`\n\nJSON Example:\n\n`{\"incident\": {\"custom_fields_values\": {\"custom_fields_value\": [{\"name\": \"field name\",\"value\": \"content\"}]}}}`<br><br><hr></hr>",
-    "version": "0.2.5",
+      "All SolarWinds Service Desk API definitions\n# General Concepts\n## Service URL\nFor US based customers, please use `https://api.samanage.com`\n\n For European based customers, please use `https://apieu.samanage.com`\n\nFor APJ based customers, please use `https://apiau.samanage.com`\n\n## Formats\n\nYou can use XML or JSON format for your request.\n\nXML Example: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/vnd.samanage.v2.1+xml\" -X GET https://api.samanage.com/incidents.xml`\n\nJSON Example: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/vnd.samanage.v2.1+json\" -H \"Content-Type: application/json\" -X GET https://api.samanage.com/incidents.json`\n\nFor create and update, the provided data needs to be in the correct format.\n\nXML Example: `<incident> <field_to_update>content</field_to_update> </incident>`\n\nJSON Example: `{\"incident\": {\"field_to_update\": \"content\"}}`\n\nTo clear fields, use the following format:\n\nXML Example: `<incident> <field_to_update></field_to_update> </incident>`\n\nJSON Example: `{\"incident\": {\"field_to_update\": \"\"}}`\n\n## Authentication\nThe API authentication is token-based. Admins can generate a token directly from the user setup page.  The token is needed by the API developer to gain access to specific items in SolarWinds accessible only via the API. For more details click here [Token authentication for API integration](https://documentation.solarwinds.com/en/success_center/swsd/content/completeguidetoswsd/token-authentication-for-api-integration.htm). When an admin re-generates their token (via the user setup page), all previously generated tokens become invalid.\n\nThe tokens are relatively long strings that resemble the following: <div style=\"word-wrap: break-word;\"> AAAZWV0YXkubmF0YW4rNUBzYW1hbmFnZS5jb20hbGciOiJIUzUxMiJ9.eyJ1c2VyX2ljIjoxMjU2OTQzLCJnZW5lcmF0ZWRfYXQiOiIyMDE3LTA2LTA3IDA5OjE3OjI5In0.j_H15qzJJr9vXGAHCThLEOQrE9GGbjMxZJOs5zAf_iqaGqxlIOAmvPpBx0td_C3r7dliAfXXIgdqhZHVoK1KTwAzd1</div>\n\nIn order to supply the API token you should pass X-Samanage-Authorization header in the following format: “Bearer API_TOKEN_STRING”.\n\nThe API call resembles the following:\n\n`curl -H \"X-Samanage-Authorization: Bearer AAAZWV0YXkubmF0YW4rNUBzYW1hbmFnZS5jb20hbGciOiJIUzUxMiJ9.eyJ1c2VyX2ljIjoxMjU2OTQzLCJnZW5lcmF0ZWRfYXQiOiIyMDE3LTA2LTA3IDA5OjE3OjI5In0.j_H15qzJJr9vXGAHCThLEOQrE9GGbjMxZJOs5zAf_iqaGqxlIOAmvPpBx0td_C3r7dliAfXXIgdqhZHVoK1KTwAzd1\" -H \"Accept: application/vnd.samanage.v2.1+json\" https://api.samanage.com/hardwares.json`\n\nIf the authentication fails, a “401 Unauthorized” message will be returned.\n## Security\nSWSD uses a secured API channel. To connect to the regional API server, use the account admin users’ token information and connect using Token-based authentication. Requests should never be transferred in plain text over the wire. Instead, use SSL version 1.2 or higher (which can be accessed using https://) to ensure that all communication with the server is encrypted and secured.\n## Limitations\nTo ensure API performance and avoid denial of service, we employ API call limits based per minute as defined by the Service Desk plan of the endpoint user.\n\nPackages:\n\nAdvanced Plan - 1000 calls per minute\n\nPremier Plan - 1500 calls per minute\n## Versioning\nClients must provide the version number they are ready to work with in the “Accept” HTTP header. A valid \"Accept\" header should specify current content type and version number. For example, “application/vnd.samanage.v2.1+xml”.\n When no “Accept” header is specified, the API will default to version 2.1.\nIf you request an API version that is no longer supported, the API will respond with an HTTP status code of “406 – Not Acceptable”.\n\nExample: \n`curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/vnd.samanage.v2.1+json\" https://api.samanage.com/hardwares.json`\n## Updates History\n## Pagination\nEvery response with a large data set will be paginated. The response will include the pagination data as headers and links (formatted as <url>; rel=”relative”). For example:\n\nX-Per-Page: 50\n\nX-Total-Count: 3099\n\nX-Total-Pages: 62\n\nLink: `<https://api.samanage.com/incidents.xml?page=1>`; rel=\"first\",\n\n`<https://api.samanage.com/incidents.xml?page=8>`; rel=\"prev\",\n\n`<https://api.samanage.com/incidents.xml?page=10>`; rel=\"next\",\n\n`<https://api.samanage.com/incidents.xml?page=62>`; rel=\"last\"\n\nYou can request a specific page by providing a “page” parameter. For example, to request the third page of the hardware list, you can use the following command: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" https://api.samanage.com/hardwares.json?page=3`\n\nTo control the number of rows returned, provide the per_page parameter. For example, to request 100 rows with each results page, you can use the following command: `curl -H \"X-Samanage-Authorization: Bearer TOKEN\" https://api.samanage.com/hardwares.json?per_page=100`\n## API Entry Point\n All communication with the API begins with a list of available services. Although it is possible to get directly to a specific service URL, we advise you begin with the api.xml entry point. This ensures your program will run seamlessly if changes are made to the underlying URLs for services in future versions of the API.\n\n**Request**\n\nGET api.samanage.com/api.json \n`curl -H \"X-Samanage-Authorization: Bearer TOKEN\" -H \"Accept: application/json\" -X GET https://api.samanage.com/api.json`\n\n**Response**\n\n`[{\"name\":\"Computers List\",\"href\":\"https://api.samanage.com/hardwares.json\"},`\n\n`{\"name\":\"Helpdesk Incidents List\",\"href\":\"https://api.samanage.com/incidents.json\"},`\n\n`{\"name\":\"Changes List\",\"href\":\"https://api.samanage.com/changes.json\"},`\n\n`...]`\n## Short / long layout\nFor all APIs, you can specify the layout (short / long). This affects the length of the returned records, and is relevant for changes, contracts, hardwares, incidents, other assets, problems, and solutions.\n\nTo use, add the parameter to the request: “?layout=short” or “?layout=long”. If not present, the default is “short”.\n## Searching\nYou can search for records by using query parameters on top of the base URL. For example, when requesting a list of hardwares, you may want to limit them to only those with a specific IP address. This could be accomplished with a request like -\n\n GET api.samanage.com/hardwares.xml?ip_address=123.456*\n\nHere, ip_address is a query parameter that implements a filter where the IP equals 123.456.xxx.xxx.\n\nOther examples: `https://api.samanage.com/other_assets.json?asset_id=XXXXXXXX`, `https://api.samanage.com/hardwares.json?asset_tag=XXXXXXXX`\n## Date formats\nThe following date formats are allowed as input when updating date fields:\n\n* January 21, 2015\n* January 21 2015\n* Jan 21, 2015\n* Jan 21 2015\n* 21/1/2015\n* 2015/1/21\n* 21-1-2015\n* 2015-1-21\n*21.1.2015 \n* 2015.1.21\n## Custom fields\nTo set custom fields, use the following data format:\n\n XML Example:\n\n`<incident><custom_fields_values>`\n\n`<custom_fields_value><name>field name</name><value>content</value></custom_fields_value>`\n\n`</custom_fields_values></incident>`\n\nJSON Example:\n\n`{\"incident\": {\"custom_fields_values\": {\"custom_fields_value\": [{\"name\": \"field name\",\"value\": \"content\"}]}}}`\n## API filtering\nYou have two options for filtering: by days or by time. You can also use custom ranges for filtering by days.\n\n**Filter by fixed days or time**\n\n* Filter by fixed days\n\n  `{api.samanage.com}/incidents?updated={days} - Last X days` - Options for Last X days: 1-90, or 365 (example: 365)\n\n* Filter by relative times\n\n   `{api.samanage.com}/incidents?updated={hours}h - Last X hours` - Options for hours: 1-23 (example: 7h)\n\n**Filter using a custom range**\n\n* Select the date and time range in ISO 8601 UTC format.\n\n* Filter by updated_from and updated_to.\n\n   &#9675; Updated_from indicates the range start.\n\n   &#9675; Updated_to indicates the range end.\n\n   **Examples:**\n\n  Get incidents updated in a specific date/time range - `incidents.json?updated_from='2023-11-29T08:00'&updated_to='2023-11-30T08:00'`\n\n    Get incidents updated from a specific date/time until now - `incidents.json?updated_from='2023-11-29T08:00'`\n\n    Get incidents created in a specific date/time range - `incidents.json?created_from='2023-11-29T08:00'&created_to='2023-11-30T08:00'`\n\n    Get incidents created from a specific date/time until now - `incidents.json?created_from='2023-11-29T08:00'`\n\n**Filter using a custom date (custom_gte to custom_lte option)** - *Deprecated*\n\n &nbsp; &nbsp; **Examples:**\n\n &nbsp; &nbsp; Get all incidents with an updated or created date greater than or equal to a specific date and less than or equal to a different specific date -\n\n &nbsp; &nbsp; `{api.samanage.com}/incidents?updated=Select Date Range&updated_custom_gte={Date/Datetime}&updated_custom_lte={Date/datetime}`<br><br><hr></hr>",
+    "version": "0.2.19",
     "x-logo": {
       "url": "https://tse4.mm.bing.net/th?id=OIP.lhiASqIhZ7Ow90BTOuu5kAHaEH&pid=Api&P=0&w=301&h=168",
       "href": "https://support.solarwinds.com"
@@ -17,7 +17,8 @@
   },
   "servers": [
     { "url": "https://api.samanage.com" },
-    { "url": "https://apieu.samanage.com" }
+    { "url": "https://apieu.samanage.com" },
+    { "url": "https://apiau.samanage.com" }
   ],
   "paths": {
     "/incidents/{id}": { "$ref": "paths/incidents/incident_by_id.json" },

data/lib/definitions/paths/changes/change_by_id.json

@@ -5,7 +5,8 @@
       "tags": ["Change"],
       "parameters": [
         { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-        { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+        { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+        { "$ref": "../../common/components.json#/components/request/parameters/layout_changes" }
       ],
       "responses": {
         "200": {
@@ -13,7 +14,10 @@
           "content": {
             "application/json": {
               "schema": { "$ref": "../../common/schemas/service_desk/change.json#/components/schemas/response" },
-              "example": { "$ref": "../../common/examples/change.json#/examples/response/json" }
+              "examples": {
+                "layout=short": { "value": { "$ref": "../../common/examples/change.json#/examples/response/json" } },
+                "layout=long": { "value": { "$ref": "../../common/examples/change.json#/examples/response_long/json" } }
+              }
             },
             "application/xml": { "schema": { "$ref": "../../common/schemas/service_desk/change.json#/components/schemas/response" } }
           }

data/lib/definitions/paths/changes/changes.json

@@ -4,7 +4,8 @@
       "description": "List of changes",
       "tags": ["Change"],
       "parameters": [
-        { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+        { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+        { "$ref": "../../common/components.json#/components/request/parameters/layout_changes" }
       ],
       "responses": {
         "200": {
@@ -16,7 +17,10 @@
                 "type": "array",
                 "items": { "allOf": [{ "$ref": "../../common/schemas/service_desk/change.json#/components/schemas/response" }] }
               },
-              "example": [{ "$ref": "../../common/examples/change.json#/examples/response/json" }]
+              "examples": {
+                "layout=short": { "value": [{ "$ref": "../../common/examples/change.json#/examples/response/json" }] },
+                "layout=long": { "value": [{ "$ref": "../../common/examples/change.json#/examples/response_long/json" }] }
+              }
             },
             "application/xml": {
               "schema": {

data/lib/definitions/paths/contracts/contract_by_id.json

@@ -5,13 +5,20 @@
     "tags": ["Contract"],
     "parameters": [
       { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-      { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout_contracts" }
     ],
     "responses": {
       "200": {
         "description": "Object was returned correctly",
         "content": {
-          "application/json": { "schema": { "$ref": "../../common/schemas/procurement/contract.json#/components/schemas/response" } },
+          "application/json": { 
+            "schema": { "$ref": "../../common/schemas/procurement/contract.json#/components/schemas/response" }, 
+            "examples": {
+              "layout=short": { "value": { "$ref": "../../common/examples/contract.json#/examples/response/json" } },
+              "layout=long": { "value": { "$ref": "../../common/examples/contract.json#/examples/response_long/json" } }
+            }
+          },
           "application/xml": { "schema": { "$ref": "../../common/schemas/procurement/contract.json#/components/schemas/response" } }
         }
       },

data/lib/definitions/paths/contracts/contracts.json

@@ -4,7 +4,8 @@
     "description": "List of contracts",
     "tags": ["Contract"],
     "parameters": [
-      { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout_contracts" }
     ],
     "responses": {
       "200": {
@@ -15,6 +16,10 @@
               "description": "List of contracts",
               "type": "array",
               "items": { "$ref": "../../common/schemas/procurement/contract.json#/components/schemas/response" }
+            },
+            "examples": {
+              "layout=short": { "value": [{ "$ref": "../../common/examples/contract.json#/examples/response/json" }] },
+              "layout=long": { "value": [{ "$ref": "../../common/examples/contract.json#/examples/response_long/json" }] }
             }
           },
           "application/xml": {

data/lib/definitions/paths/hardwares/hardware_by_id.json

@@ -5,7 +5,8 @@
     "tags": ["Hardware"],
     "parameters": [
       { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-      { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout_hardwares" }
     ],
     "responses": {
       "200": {
@@ -13,7 +14,10 @@
         "content": {
           "application/json": {
             "schema": { "$ref": "../../common/schemas/inventory/hardware.json#/components/schemas/response" },
-            "example": { "$ref": "../../common/examples/hardware.json#/examples/response" }
+            "examples": {
+              "layout=short": { "value": { "$ref": "../../common/examples/hardware.json#/examples/response/json" } },
+              "layout=long": { "value": { "$ref": "../../common/examples/hardware.json#/examples/response_long/json" } }
+            }
           },
           "application/xml": { "schema": { "$ref": "../../common/schemas/inventory/hardware.json#/components/schemas/response" } }
         }

data/lib/definitions/paths/hardwares/hardwares.json

@@ -4,7 +4,8 @@
     "description": "List of hardwares",
     "tags": ["Hardware"],
     "parameters": [
-      { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout_hardwares" }
     ],
     "responses": {
       "200": {
@@ -16,7 +17,10 @@
               "type": "array",
               "items": { "$ref": "../../common/schemas/inventory/hardware.json#/components/schemas/response" }
             },
-            "example": [{ "$ref": "../../common/examples/hardware.json#/examples/response" }]
+            "examples": {
+              "layout=short": { "value": [{ "$ref": "../../common/examples/hardware.json#/examples/response/json" }] },
+              "layout=long": { "value": [{ "$ref": "../../common/examples/hardware.json#/examples/response_long/json" }] }
+            }
           },
           "application/xml": {
             "schema": {

data/lib/definitions/paths/incidents/incident_by_id.json

@@ -5,7 +5,8 @@
     "tags": ["Incident"],
     "parameters": [
       { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-      { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout" }
     ],
     "responses": {
       "200": {
@@ -13,7 +14,10 @@
         "content": {
           "application/json": {
             "schema": { "$ref": "../../common/schemas/service_desk/incident.json#/components/schemas/response" },
-            "example": { "$ref": "../../common/examples/incident.json#/examples/response/json" }
+            "examples": {
+              "layout=short": { "value": { "$ref": "../../common/examples/incident.json#/examples/response/json" } },
+              "layout=long": { "value": { "$ref": "../../common/examples/incident.json#/examples/response_long/json" } }
+            }
           },
           "application/xml": { "schema": { "$ref": "../../common/schemas/service_desk/incident.json#/components/schemas/response" } }
         }

data/lib/definitions/paths/incidents/incidents.json

@@ -5,7 +5,8 @@
     "tags": ["Incident"],
     "parameters": [
       { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-      { "$ref": "../../common/components.json#/components/request/parameters/filter" }
+      { "$ref": "../../common/components.json#/components/request/parameters/filter" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout" }
     ],
     "responses": {
       "200": {
@@ -17,7 +18,10 @@
               "type": "array",
               "items": { "$ref": "../../common/schemas/service_desk/incident.json#/components/schemas/response" }
             },
-            "example": [{ "$ref": "../../common/examples/incident.json#/examples/response/json" }]
+            "examples": {
+              "layout=short": { "value": [{ "$ref": "../../common/examples/incident.json#/examples/response/json" }] },
+              "layout=long": { "value": [{ "$ref": "../../common/examples/incident.json#/examples/response_long/json" }] }
+            }
           },
           "application/xml": {
             "schema": {

data/lib/definitions/paths/other_assets/other_asset_by_id.json

@@ -5,13 +5,20 @@
     "tags": ["Other Asset"],
     "parameters": [
       { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-      { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout_other_assets" }
     ],
     "responses": {
       "200": {
         "description": "Object was returned correctly",
         "content": {
-          "application/json": { "schema": { "$ref": "../../common/schemas/inventory/other_asset.json#/components/schemas/response" } },
+          "application/json": { 
+            "schema": { "$ref": "../../common/schemas/inventory/other_asset.json#/components/schemas/response" },
+            "examples": {
+              "layout=short": { "value": { "$ref": "../../common/examples/other_asset.json#/examples/response/json" } },
+              "layout=long": { "value": { "$ref": "../../common/examples/other_asset.json#/examples/response_long/json" } }
+            }
+          },
           "application/xml": { "schema": { "$ref": "../../common/schemas/inventory/other_asset.json#/components/schemas/response" } }
         }
       },

data/lib/definitions/paths/other_assets/other_assets.json

@@ -4,7 +4,8 @@
     "description": "List of other assets",
     "tags": ["Other Asset"],
     "parameters": [
-      { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/layout_other_assets" }
     ],
     "responses": {
       "200": {
@@ -15,6 +16,10 @@
               "description": "List of other assets",
               "type": "array",
               "items": { "$ref": "../../common/schemas/inventory/other_asset.json#/components/schemas/response" }
+            },
+            "examples": {
+              "layout=short": { "value": [{ "$ref": "../../common/examples/other_asset.json#/examples/response/json" }] },
+              "layout=long": { "value": [{ "$ref": "../../common/examples/other_asset.json#/examples/response_long/json" }] }
             }
           },
           "application/xml": {

data/lib/definitions/paths/problems/problem_by_id.json

@@ -5,7 +5,8 @@
       "tags": ["Problem"],
       "parameters": [
         { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-        { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+        { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+        { "$ref": "../../common/components.json#/components/request/parameters/layout_problems" }
       ],
       "responses": {
         "200": {
@@ -13,7 +14,10 @@
           "content": {
             "application/json": {
               "schema": { "$ref": "../../common/schemas/service_desk/problem.json#/components/schemas/response" },
-              "example": { "$ref": "../../common/examples/problem.json#/examples/response/json" }
+              "examples": {
+                "layout=short": { "value": { "$ref": "../../common/examples/problem.json#/examples/response/json" } },
+                "layout=long": { "value": { "$ref": "../../common/examples/problem.json#/examples/response_long/json" } }
+              }
             },
             "application/xml": { "schema": { "$ref": "../../common/schemas/service_desk/problem.json#/components/schemas/response" } }
           }

data/lib/definitions/paths/problems/problems.json

@@ -4,7 +4,8 @@
       "description": "List of problems",
       "tags": ["Problem"],
       "parameters": [
-        { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+        { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+        { "$ref": "../../common/components.json#/components/request/parameters/layout_problems" }
       ],
       "responses": {
         "200": {
@@ -16,7 +17,10 @@
                 "type": "array",
                 "items": { "allOf": [{ "$ref": "../../common/schemas/service_desk/problem.json#/components/schemas/response" }] }
               },
-              "example": [{ "$ref": "../../common/examples/problem.json#/examples/response/json" }]
+              "examples": {
+                "layout=short": { "value": [{ "$ref": "../../common/examples/problem.json#/examples/response/json" }] },
+                "layout=long": { "value": [{ "$ref": "../../common/examples/problem.json#/examples/response_long/json" }] }
+              }
             },
             "application/xml": {
               "schema": {

data/lib/definitions/paths/purchase_orders/purchase_order_by_id.json

@@ -26,14 +26,15 @@
     "tags": ["Purchase Order"],
     "parameters": [
       { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-      { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/edit_mode" }
     ],
     "requestBody": {
       "required": true,
       "description": "Purchase Order fields to update",
       "content": {
         "application/json": { "schema": { "$ref": "../../common/schemas/procurement/purchase_order.json#/components/schemas/request/put" } },
-        "application/xml": { "schema": { "$ref": "../../common/schemas/procurement/purchase_order.json#/components/schemas/request/put" } }
+        "application/xml": { "schema": { "$ref": "../../common/schemas/procurement/purchase_order.json#/components/schemas/request/put_for_xml" } }
       }
     },
     "responses": {

data/lib/definitions/paths/purchase_orders/purchase_orders.json

@@ -37,14 +37,15 @@
     "description": "Create new purchase order",
     "tags": ["Purchase Order"],
     "parameters": [
-      { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+      { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+      { "$ref": "../../common/components.json#/components/request/parameters/edit_mode" }
     ],
     "requestBody": {
       "required": true,
       "description": "Purchase order fields to fill",
       "content": {
         "application/json": { "schema": { "$ref": "../../common/schemas/procurement/purchase_order.json#/components/schemas/request/post" } },
-        "application/xml": { "schema": { "$ref": "../../common/schemas/procurement/purchase_order.json#/components/schemas/request/post" } }
+        "application/xml": { "schema": { "$ref": "../../common/schemas/procurement/purchase_order.json#/components/schemas/request/post_for_xml" } }
       }
     },
     "responses": {

data/lib/definitions/paths/solutions/solution_by_id.json

@@ -5,7 +5,8 @@
       "tags": ["Solution"],
       "parameters": [
         { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
-        { "$ref": "../../common/components.json#/components/request/parameters/id_param" }
+        { "$ref": "../../common/components.json#/components/request/parameters/id_param" },
+        { "$ref": "../../common/components.json#/components/request/parameters/layout_solutions" }
       ],
       "responses": {
         "200": {
@@ -13,7 +14,10 @@
           "content": {
             "application/json": {
               "schema": { "$ref": "../../common/schemas/service_desk/solution.json#/components/schemas/response" },
-              "example": { "$ref": "../../common/examples/solution.json#/examples/response/json" }
+              "examples": {
+                "layout=short": { "value": { "$ref": "../../common/examples/solution.json#/examples/response/json" } },
+                "layout=long": { "value": { "$ref": "../../common/examples/solution.json#/examples/response_long/json" } }
+              }
             },
             "application/xml": { "schema": { "$ref": "../../common/schemas/service_desk/solution.json#/components/schemas/response" } }
           }

data/lib/definitions/paths/solutions/solutions.json

@@ -4,7 +4,8 @@
       "description": "List of solutions",
       "tags": ["Solution"],
       "parameters": [
-        { "$ref": "../../common/components.json#/components/request/parameters/token_param" }
+        { "$ref": "../../common/components.json#/components/request/parameters/token_param" },
+        { "$ref": "../../common/components.json#/components/request/parameters/layout_solutions" }
       ],
       "responses": {
         "200": {
@@ -16,7 +17,10 @@
                 "type": "array",
                 "items": { "$ref": "../../common/schemas/service_desk/solution.json#/components/schemas/response" }
               },
-              "example": [{ "$ref": "../../common/examples/solution.json#/examples/response/json" }]
+              "examples": {
+                "layout=short": { "value": [{ "$ref": "../../common/examples/solution.json#/examples/response/json" }] },
+                "layout=long": { "value": [{ "$ref": "../../common/examples/solution.json#/examples/response_long/json" }] }
+              }
             },
             "application/xml": {
               "schema": {

metadata

@@ -1,9 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: solarwinds-itsm-api-definitions
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.19
 platform: ruby
 authors:
+- Alexander Nagiev
 - Maor Ovadia
 - Jonathan Goldstein
 - Darth Vader
@@ -11,13 +12,14 @@ authors:
 - Guy Frieman
 - Dor Leventer
 - Elad Kaufman
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-23 00:00:00.000000000 Z
+date: 2024-12-22 00:00:00.000000000 Z
 dependencies: []
 description: SolarWinds ITSM OpenAPI definitions gem
 email:
+- alexander.nagiev@solarwinds.com
 - maor.ovadia@solarwinds.com
 - jonathan.goldstein@solarwinds.com
 - sagi.gold@solarwinds.com
@@ -33,13 +35,20 @@ files:
 - Redocly/redoc/favicon.ico
 - Redocly/redoc/schema/resolved_schema.json
 - lib/definitions/common/components.json
+- lib/definitions/common/examples/associations/category.json
+- lib/definitions/common/examples/associations/department.json
+- lib/definitions/common/examples/associations/group_assignee.json
+- lib/definitions/common/examples/associations/site.json
+- lib/definitions/common/examples/associations/sub_category.json
 - lib/definitions/common/examples/catalog_item.json
 - lib/definitions/common/examples/change.json
 - lib/definitions/common/examples/change_catalog.json
 - lib/definitions/common/examples/change_request.json
 - lib/definitions/common/examples/configuration_item.json
+- lib/definitions/common/examples/contract.json
 - lib/definitions/common/examples/hardware.json
 - lib/definitions/common/examples/incident.json
+- lib/definitions/common/examples/other_asset.json
 - lib/definitions/common/examples/problem.json
 - lib/definitions/common/examples/release.json
 - lib/definitions/common/examples/service_request.json
@@ -149,7 +158,7 @@ homepage: https://rubygems.org/gems/solarwinds-itsm-api-definitions
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -164,8 +173,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 3.4.10
+signing_key: 
 specification_version: 4
 summary: OpenAPI definitions
 test_files: []