Resolver error at paths./users.get.responses.200.schema.$ref

I keep getting this error:

Resolver error at paths./users.get.responses.200.schema.$ref
Could not resolve reference because of: Could not resolve pointer: /definitions/users list does not exist in document

Here is the code.

module.exports = function (app) {

  const paginate = app.get('paginate');

  let swaggerDocs = {
    description: 'Service for managing users',
    definitions: {
      users: {
        "type": "object",
        "required": [
          "username",
          "password"
        ],
        "properties": {
          "username": {
            "type": "string",
            "description": "The email of the user"
          },
          "password": {
            "type": "string",
            "description": "The password of the user for figo."
          }
        }
      }
    }

  }
  const options = {
    name: 'users',
    paginate,
    app: app
  };

  // Initialize our service with any options it requires
  app.use('/users', Object.assign(createService(options), { docs: swaggerDocs }));

  // Get our initialized service so that we can register hooks and filters
  const service = app.service('users');

  service.hooks(hooks);

};

What am I missing?

[Mairu]

When adding definitions with the service.docs.definitions option instead of service.docs.definition you have to define the list definition yourself with correct schema as ref or object. See examples how to do it.

[binarytracer]

  const serviceInstance = createService(options);
  serviceInstance.docs = {

    description: 'list of users',
    definitions: {
      users: {
        'type': 'object',
        'required': [
          'username', 'password'
        ],
        'properties': {
          'username': {
            'type': 'string',
            'description': 'user username'
          },
          'email': {
            'type': 'string',
            'description': 'The email address of the user'
          },
          'password': {
            'type': 'string',
            'description': 'encrypted password of the user'
          }
        }
      },
      'users list': {
        'type': 'array'
      }
    }
  };

i think the only missing is ‘users list’, part. I hope im right.