defineRoute.groovy

def defineRoute(routeBuilder) {
	routeBuilder.categories {
		schema {
			properties {
				name { 
					type string, 
					description "a name" 
				}
				links {
					brand "brands"
				}
			}
			required ['name']
			name "Category"
		}

		get { req, res ->
			// any kind of dynamic validation, custom authorization can be done in line
			"people.get logic goes here"
		}
		.document {  docs -> docs.summary = "Overridden summary for post"; doc }

		post { req, res, data ->
			"people.get logic goes here"
		}

		"{id}" {
			get { req, res ->
				"people/{id}/"
			}

			patch { req, res, data ->
				"people/{id}/"
			}

			delete { req, res ->
				"people/{id}/"
			}
		}
	}
}