{ "swagger": "2.0", "info": { "contact": {} }, "paths": { "/tasks": { "post": { "description": "Create a new task for a specific repository", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Tasks" ], "summary": "Create a new task", "parameters": [ { "description": "Request body to create a task", "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/taskcontroller.CreateTaskDTO" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/taskcontroller.CreateTaskResponse" } }, "400": { "description": "Invalid JSON or missing required fields", "schema": { "$ref": "#/definitions/errors.ErrResponse" } }, "500": { "description": "Internal server error", "schema": { "$ref": "#/definitions/errors.ErrResponse" } } } } } }, "definitions": { "errors.ErrResponse": { "type": "object", "properties": { "code": { "description": "application-specific error code", "type": "integer" }, "error": { "description": "application-level error message, for debugging", "type": "string" }, "status": { "description": "user-level status message", "type": "string" } } }, "models.TaskStatus": { "type": "integer", "enum": [ 0, 1, 2, 3, 4 ], "x-enum-comments": { "StatusCancelled": "4", "StatusCompleted": "2", "StatusFailed": "3", "StatusInProgress": "1", "StatusPending": "0" }, "x-enum-varnames": [ "StatusPending", "StatusInProgress", "StatusCompleted", "StatusFailed", "StatusCancelled" ] }, "taskcontroller.CreateTaskDTO": { "type": "object", "properties": { "repo": { "type": "string" } } }, "taskcontroller.CreateTaskResponse": { "type": "object", "properties": { "status": { "$ref": "#/definitions/models.TaskStatus" }, "taskID": { "type": "integer" } } } } }