Example API with RAML Step 6

api.raml

# document root and types

/users:
  # get operation
  post:
    description: Create new user.
    body:
      type: UserBase
    responses:
      201:
        description: New user created successful.
      400:
        description: Required properties missing or validation issues.
        body:
          type: Error
  /{userId}:
    uriParameters:
      userId: integer
    put:
      description: Update user.
      body:
        type: UserBase
      responses:
        200:
          description: User updated successful.
          body:
            type: User
        400:
          description: Required properties missing or validation issues.
          body:
            type: Error
        404:
          description: Unkown user.
          body:
            type: Error