Skip to main content
Nintex Community Menu Bar
Question

Create a swagger 2.0 file for SharePoint 2019 Rest SmartObject

  • January 15, 2026
  • 0 replies
  • 9 views

Forum|alt.badge.img+1

Hello together,

i have a problem with a swagger file.K2 Five shows the following error message.

 

I tried to call the a specific list and get the items in this list.

 

My swagger file looks like the following:

 

{

  "swagger": "2.0",

  "info": {

    "title": "SharePoint 2019 List Items API",

    "description": "Get SharePoint list items by site path and list title (for K2 Five SmartObject)",

    "version": "1.0.0"

  },

  "host": "test.host.de",

  "basePath": "",

  "schemes": [

    "https"

  ],

  "consumes": [

    "application/json"

  ],

  "produces": [

    "application/json"

  ],

  "paths": {

    "/{sitePath}/_api/web/lists/GetByTitle('{listTitle}')/items": {

      "get": {

        "summary": "Get list items",

        "operationId": "GetListItems",

        "parameters": [

          {

            "name": "sitePath",

            "in": "path",

            "description": "Site relative path",

            "required": true,

            "type": "string"

          },

          {

            "name": "listTitle",

            "in": "path",

            "description": "Title of the SharePoint list",

            "required": true,

            "type": "string"

          }

        ],

        "responses": {

          "200": {

            "description": "Success",

            "schema": {

              "$ref": "#/definitions/SharePointListItemsResponse"

            }

          },

          "401": {

            "description": "Unauthorized – authentication failed or missing"

          },

          "404": {

            "description": "Not Found – site or list does not exist"

          }

        }

      }

    }

  },

  "definitions": {

    "SharePointListItemsResponse": {

      "type": "object",

      "properties": {

        "value": {

          "type": "array",

          "items": {

            "$ref": "#/definitions/SharePointListItem"

          }

        }

      }

    },

    "SharePointListItem": {

      "type": "object",

      "properties": {

        "Id": {

          "type": "integer"

        },

        "Title": {

          "type": "string"

        }

      },

      "additionalProperties": true

    }

  }

}

 

and I get the following error message:

 

I hope you can help me to solve the problems.

 

Best regards

Matthias