Example API with RAML Step 4

api.raml

# document root

types:
  Gender:
    type: string
    enum: [ male, female ]
  User:
    properties:
      id: integer
      name: string
      gender?: Gender
    example:
      {
        "id": 42,
        "name": "John Doe",
        "gender": "male"
      }
  Users: User[]
  
# endpoint definiton