Building Enterprise JavaScript Applications

Specifying the Replace Profile endpoint

The last thing we will demonstrate is describing the Replace Profile endpoint. This endpoint requires the user to be logged in and provides the token in the request.

But first, let's use everything we have learned so far to define the parameters, request bodies, and responses for the Replace Profile endpoint:

...components: ... responses:    Success:      description: Success    ...    ErrorUnauthorized:      description: Unauthorized      content:        application/json:          schema:            $ref: '#/components/schemas/Error'    ...  securitySchemes:    token:      type: http      scheme: bearer      bearerFormat: JWTpaths:  /users/{userId}/profile:    put:      tags:        - Profile      summary: Replaces the Profile of the User with a new Profile      security:        - token: [] parameters: ...