Should be an absolute uri

This error means that the authorizationUrl cannot be an empty string. It must specify the authorization URL of the OAuth 2.0 identity provider used by the API.

 

Other errors ("declared path parameter <..> needs to be defined ...") mean that endpoints that have path parameters must also define them in the parameters section, like so:

 

paths:
  /v1/devices/{document_id}:
    patch:
      parameters:
        - in: path
          name: document_id
          required: true
          type: integer      # or 'string' or whatever the type is

        # Other parameters
        - ...

 

Note that path parameters must have required: true because they are always required.