From 796ec75b38f44413d6a1705ae0852bf2b8fc520d Mon Sep 17 00:00:00 2001 From: Brad Rydzewski Date: Tue, 23 Jun 2015 19:08:18 -0700 Subject: [PATCH] swagger docs --- doc/swagger.yml | 28 ++++++++++++++++++++++++---- 1 file changed, 24 insertions(+), 4 deletions(-) diff --git a/doc/swagger.yml b/doc/swagger.yml index 673a618a..a9a74a81 100644 --- a/doc/swagger.yml +++ b/doc/swagger.yml @@ -34,6 +34,8 @@ paths: - name: name in: path type: string + tags: + - repository description: Returns the repository based on name. security: - accessToken: [] @@ -54,6 +56,14 @@ paths: - name: name in: path type: string + - name: repo + in: body + description: The updated repository JSON + schema: + $ref: '#/definitions/Repo' + required: true + tags: + - repository description: Updates the repository. security: - accessToken: [] @@ -70,6 +80,8 @@ paths: - name: name in: path type: string + tags: + - repository description: Deletes the repository. security: - accessToken: [] @@ -82,6 +94,8 @@ paths: - name: name in: path type: string + tags: + - repository description: Watches the named repository. security: - accessToken: [] @@ -95,6 +109,8 @@ paths: - name: name in: path type: string + tags: + - repository description: Unwatches the repository. security: - accessToken: [] @@ -108,6 +124,8 @@ paths: - name: name in: path type: string + tags: + - build description: Returns recent builds for the repository based on name. security: - accessToken: [] @@ -130,6 +148,8 @@ paths: - name: number in: path type: integer + tags: + - build description: Returns the repository build by number. security: - accessToken: [] @@ -143,10 +163,8 @@ paths: description: Returns the currently authenticated user. security: - accessToken: [] - consumes: - - application/json - produces: - - application/json + tags: + - user responses: "200": description: The currently authenticated user. @@ -165,6 +183,8 @@ paths: description: Updates the currently authenticated user. produces: - application/json + tags: + - user parameters: - name: user in: body