docs: create swagger api documentation for endpoints

modules/structs/issue.go

@@ -115,6 +115,20 @@ type EditIssueOption struct {
 	RemoveDeadline *bool      `json:"unset_due_date"`
 }
 
+// MoveIssuesOption options for moving issues
+type MovedIssuesOption struct {
+	Issues []struct {
+		IssueID int64 `json:"issueID"`
+		Sorting int64 `json:"sorting"`
+	} `json:"issues"`
+}
+
+// UpdateIssuesOption options for updating issues
+type UpdateIssuesOption struct {
+	ProjectID int64   `json:"project_id"`
+	Issues    []int64 `json:"issues"`
+}
+
 // EditDeadlineOption options for creating a deadline
 type EditDeadlineOption struct {
 	// required:true

modules/structs/project.go

@@ -21,6 +21,7 @@ type Project struct {
 	ClosedDateUnix int64 `json:"closed_date_unix"`
 }
 
+// CreateProjectOption options for creating a project
 type CreateProjectOption struct {
 	// required:true
 	Title        string `json:"title" binding:"Required;MaxSize(100)"`
@@ -28,3 +29,18 @@ type CreateProjectOption struct {
 	TemplateType uint8  `json:"template_type"`
 	CardType     uint8  `json:"card_type"`
 }
+
+// EditProjectOption options for editing a project
+type EditProjectOption struct {
+	Title    string `json:"title" binding:"MaxSize(100)"`
+	Content  string `json:"content"`
+	CardType uint8  `json:"card_type"`
+}
+
+// MoveColumnsOption options for moving columns
+type MovedColumnsOption struct {
+	Columns []struct {
+		ColumnID int64 `json:"columnID"`
+		Sorting  int64 `json:"sorting"`
+	} `json:"columns"`
+}

modules/structs/project_column.go

@@ -12,6 +12,14 @@ type Column struct {
 
 // EditProjectColumnOption options for editing a project column
 type EditProjectColumnOption struct {
+	Title   string `binding:"MaxSize(100)"`
+	Sorting int8
+	Color   string `binding:"MaxSize(7)"`
+}
+
+// CreateProjectColumnOption options for creating a project column
+type CreateProjectColumnOption struct {
+	// required:true
 	Title   string `binding:"Required;MaxSize(100)"`
 	Sorting int8
 	Color   string `binding:"MaxSize(7)"`

routers/api/v1/api.go

@@ -1026,9 +1026,9 @@ func Routes() *web.Router {
 				m.Group("", func() {
 					m.Post("", bind(api.CreateProjectOption{}), project_shared.ProjectHandler("org", project_shared.CreateProject))
 					m.Group("/{id}", func() {
-						m.Post("", bind(api.EditProjectColumnOption{}), project_shared.ProjectHandler("org", project_shared.AddColumnToProject))
+						m.Post("", bind(api.CreateProjectColumnOption{}), project_shared.ProjectHandler("org", project_shared.AddColumnToProject))
 						m.Delete("", project_shared.ProjectHandler("org", project_shared.DeleteProject))
-						m.Put("", bind(api.CreateProjectOption{}), project_shared.ProjectHandler("org", project_shared.EditProject))
+						m.Put("", bind(api.EditProjectOption{}), project_shared.ProjectHandler("org", project_shared.EditProject))
 						m.Post("/move", project_shared.MoveColumns)
 						m.Post("/{action:open|close}", project_shared.ChangeProjectStatus)
 
@@ -1055,9 +1055,9 @@ func Routes() *web.Router {
 				m.Group("", func() {
 					m.Post("", bind(api.CreateProjectOption{}), project_shared.ProjectHandler("repo", project_shared.CreateProject))
 					m.Group("/{id}", func() {
-						m.Post("", bind(api.EditProjectColumnOption{}), project_shared.ProjectHandler("repo", project_shared.AddColumnToProject))
+						m.Post("", bind(api.CreateProjectColumnOption{}), project_shared.ProjectHandler("repo", project_shared.AddColumnToProject))
 						m.Delete("", project_shared.ProjectHandler("repo", project_shared.DeleteProject))
-						m.Put("", bind(api.CreateProjectOption{}), project_shared.ProjectHandler("repo", project_shared.EditProject))
+						m.Put("", bind(api.EditProjectOption{}), project_shared.ProjectHandler("repo", project_shared.EditProject))
 						m.Post("/move", project_shared.MoveColumns)
 						m.Post("/{action:open|close}", project_shared.ChangeProjectStatus)
 

routers/api/v1/shared/project.go

@@ -41,9 +41,10 @@ func ProjectHandler(model string, fn func(ctx *context.APIContext, model string)
 
 // CreateProject creates a new project
 func CreateProject(ctx *context.APIContext, model string) {
-	// swagger: operation POST /users/{username}/{reponame}/projects project createProject
+	// swagger:operation POST /{username}/{repo}/projects project createProject
 	// ---
-	// summary: Create a project
+	// summary: Create a new project
+	// description: Creates a new project for a given user and repository.
 	// consumes:
 	// - application/json
 	// produces:
@@ -52,22 +53,30 @@ func CreateProject(ctx *context.APIContext, model string) {
 	// - name: username
 	//   in: path
 	//   description: owner of the project
-	//   type: string
 	//   required: true
-	// - name: reponame
+	//   type: string
+	// - name: repo
 	//   in: path
-	//   description: repository name
+	//   description: repository name. If left '-', the project will be created for the user
-	//   type: string
 	//   required: true
+	//   type: string
 	// - name: body
 	//   in: body
+	//   description: Project data
+	//   required: true
 	//   schema:
 	//     "$ref": "#/definitions/CreateProjectOption"
 	// responses:
-	//   "200":
+	//   "201":
 	//     "$ref": "#/responses/Project"
-	//   "404":
+	//   "403":
-	//     "$ref": "#/responses/notFound"
+	//     "$ref": "#/responses/forbidden"
+	//   "412":
+	//     "$ref": "#/responses/error"
+	//   "422":
+	//     "$ref": "#/responses/validationError"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
 
 	err := checkModelType(model)
 
@@ -108,6 +117,33 @@ func CreateProject(ctx *context.APIContext, model string) {
 
 // GetProjects returns a list of projects
 func GetProjects(ctx *context.APIContext, model string) {
+	// swagger:operation GET /{username}/{repo}/projects project getProjects
+	// ---
+	// summary: Get a list of projects
+	// description: Returns a list of projects for a given user and repository.
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the projects will be returned for the user
+	//   required: true
+	//   type: string
+	// responses:
+	//   "200":
+	//     "$ref": "#/responses/ProjectList"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -150,6 +186,37 @@ func GetProjects(ctx *context.APIContext, model string) {
 
 // GetProject returns a project
 func GetProject(ctx *context.APIContext, model string) {
+	// swagger:operation GET /{username}/{repo}/projects/{id} project getProject
+	// ---
+	// summary: Get a project
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the project will be returned for the user
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// responses:
+	//   "200":
+	//     "$ref": "#/responses/Project"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -193,6 +260,39 @@ func GetProject(ctx *context.APIContext, model string) {
 
 // EditProject edits a project
 func EditProject(ctx *context.APIContext, model string) {
+	// swagger:operation PUT /{username}/{repo}/projects/{id} project editProject
+	// ---
+	// summary: Edit a project
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the project will be edited for the user
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// responses:
+	//   "201":
+	//     "$ref": "#/responses/Project"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "412":
+	//     "$ref": "#/responses/error"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -223,6 +323,36 @@ func EditProject(ctx *context.APIContext, model string) {
 
 // DeleteProject deletes a project
 func DeleteProject(ctx *context.APIContext, model string) {
+	// swagger:operation DELETE /{username}/{repo}/projects/{id} project deleteProject
+	// ---
+	// summary: Delete a project
+	// description: Deletes a specific project for a given user and repository.
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the project will be deleted for the user
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -243,11 +373,50 @@ func DeleteProject(ctx *context.APIContext, model string) {
 		return
 	}
 
-	ctx.JSON(http.StatusOK, map[string]any{"message": "project deleted successfully"})
+	ctx.Status(http.StatusNoContent)
 }
 
 // ChangeProjectStatus updates the status of a project between "open" and "close"
 func ChangeProjectStatus(ctx *context.APIContext) {
+	// swagger:operation POST /{username}/{repo}/projects/{id}/{action} project changeProjectStatus
+	// ---
+	// summary: Change the status of a project
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the project status will be changed for the user
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: action
+	//   in: path
+	//   description: action to perform (open or close)
+	//   required: true
+	//   type: string
+	//   enum:
+	//   - open
+	//   - close
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	var toClose bool
 	switch ctx.PathParam(":action") {
 	case "open":
@@ -264,10 +433,54 @@ func ChangeProjectStatus(ctx *context.APIContext) {
 		ctx.NotFoundOrServerError("ChangeProjectStatusByRepoIDAndID", project_model.IsErrProjectNotExist, err)
 		return
 	}
-	ctx.JSON(http.StatusOK, map[string]any{"message": "project status updated successfully"})
+	ctx.Status(http.StatusNoContent)
 }
 
+// AddColumnToProject adds a new column to a project
 func AddColumnToProject(ctx *context.APIContext, model string) {
+	// swagger:operation POST /{username}/{repo}/projects/{id} project addColumnToProject
+	// ---
+	// summary: Add a column to a project
+	// consumes:
+	// - application/json
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the column will be added to the user's project
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: body
+	//   in: body
+	//   description: column data
+	//   required: true
+	//   schema:
+	//     "$ref": "#/definitions/CreateProjectColumnOption"
+	// responses:
+	//   "201":
+	//     "$ref": "#/responses/Column"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "412":
+	//     "$ref": "#/responses/error"
+	//   "422":
+	//     "$ref": "#/responses/validationError"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	var err error
 	err = checkModelType(model)
 
@@ -313,7 +526,6 @@ func AddColumnToProject(ctx *context.APIContext, model string) {
 	ctx.JSON(http.StatusCreated, convert.ToColumn(ctx, column))
 }
 
-// checkProjectColumnChangePermissions check permission
 func checkProjectColumnChangePermissions(ctx *context.APIContext, model string) (*project_model.Project, *project_model.Column) {
 	if ctx.Doer == nil {
 		ctx.JSON(http.StatusForbidden, map[string]string{
@@ -369,6 +581,54 @@ func checkProjectColumnChangePermissions(ctx *context.APIContext, model string)
 
 // EditProjectColumn allows a project column's to be updated
 func EditProjectColumn(ctx *context.APIContext, model string) {
+	// swagger:operation PUT /{username}/{repo}/projects/{id}/{column-id} project editProjectColumn
+	// ---
+	// summary: Edit a project column
+	// consumes:
+	// - application/json
+	// produces:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the column will be edited for the user's project
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: column-id
+	//   in: path
+	//   description: column ID
+	//   required: true
+	//   type: integer
+	// - name: body
+	//   in: body
+	//   description: column data
+	//   required: true
+	//   schema:
+	//     "$ref": "#/definitions/EditProjectColumnOption"
+	// responses:
+	//   "201":
+	//     "$ref": "#/responses/Column"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "412":
+	//     "$ref": "#/responses/error"
+	//   "422":
+	//     "$ref": "#/responses/validationError"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -400,6 +660,40 @@ func EditProjectColumn(ctx *context.APIContext, model string) {
 
 // DeleteProjectColumn allows for the deletion of a project column
 func DeleteProjectColumn(ctx *context.APIContext, model string) {
+	// swagger:operation DELETE /{username}/{repo}/projects/{id}/{column-id} project deleteProjectColumn
+	// ---
+	// summary: Delete a project column
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the column will be deleted for the user's project
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: column-id
+	//   in: path
+	//   description: column ID
+	//   required: true
+	//   type: integer
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -462,11 +756,45 @@ func DeleteProjectColumn(ctx *context.APIContext, model string) {
 		return
 	}
 
-	ctx.JSON(http.StatusOK, map[string]string{"message": "column deleted successfully"})
+	ctx.Status(http.StatusNoContent)
 }
 
-// SetDefaultProjectColumn set default column for uncategorized issues/pulls
+// SetDefaultProjectColumn set default column for issues/pulls
 func SetDefaultProjectColumn(ctx *context.APIContext, model string) {
+	// swagger:operation POST /{username}/{repo}/projects/{id}/{column-id}/default project setDefaultProjectColumn
+	// ---
+	// summary: Set default column for issues/pulls
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the column will be set as default for the user's project
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: column-id
+	//   in: path
+	//   description: column ID
+	//   required: true
+	//   type: integer
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -484,11 +812,121 @@ func SetDefaultProjectColumn(ctx *context.APIContext, model string) {
 		return
 	}
 
-	ctx.JSON(http.StatusOK, map[string]string{"message": "default column set successfully"})
+	ctx.Status(http.StatusNoContent)
+}
+
+// MoveColumns moves or keeps columns in a project and sorts them inside that project
+func MoveColumns(ctx *context.APIContext) {
+	// swagger:operation PUT /{username}/{repo}/projects/{id}/move project moveColumns
+	// ---
+	// summary: Move columns in a project
+	// consumes:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name. If left '-', the columns will be moved for the user's project
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: body
+	//   in: body
+	//   description: columns data
+	//   required: true
+	//   schema:
+	//    "$ref": "#/definitions/MovedColumnsOption"
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
+	project, err := project_model.GetProjectByID(ctx, ctx.PathParamInt64(":id"))
+	if err != nil {
+		ctx.NotFoundOrServerError("GetProjectByID", project_model.IsErrProjectNotExist, err)
+		return
+	}
+	if !project.CanBeAccessedByOwnerRepo(ctx.ContextUser.ID, ctx.Repo.Repository) {
+		ctx.NotFound("CanBeAccessedByOwnerRepo", nil)
+		return
+	}
+
+	form := &api.MovedColumnsOption{}
+	if err = json.NewDecoder(ctx.Req.Body).Decode(&form); err != nil {
+		ctx.ServerError("DecodeMovedColumnsForm", err)
+		return
+	}
+
+	sortedColumnIDs := make(map[int64]int64)
+	for _, column := range form.Columns {
+		sortedColumnIDs[column.Sorting] = column.ColumnID
+	}
+
+	if err = project_model.MoveColumnsOnProject(ctx, project, sortedColumnIDs); err != nil {
+		ctx.ServerError("MoveColumnsOnProject", err)
+		return
+	}
+
+	ctx.Status(http.StatusNoContent)
 }
 
 // MoveIssues moves or keeps issues in a column and sorts them inside that column
 func MoveIssues(ctx *context.APIContext, model string) {
+	// swagger:operation POST /{username}/{repo}/projects/{id}/{column-id}/move project moveIssues
+	// ---
+	// summary: Move issues in a column
+	// consumes:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name.
+	//   required: true
+	//   type: string
+	// - name: id
+	//   in: path
+	//   description: project ID
+	//   required: true
+	//   type: integer
+	// - name: column-id
+	//   in: path
+	//   description: column ID
+	//   required: true
+	//   type: integer
+	// - name: body
+	//   in: body
+	//   description: issues data
+	//   required: true
+	//   schema:
+	//    "$ref": "#/definitions/MovedIssuesOption"
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
+
 	err := checkModelType(model)
 
 	if err != nil {
@@ -529,14 +967,7 @@ func MoveIssues(ctx *context.APIContext, model string) {
 		return
 	}
 
-	type movedIssuesForm struct {
+	form := &api.MovedIssuesOption{}
-		Issues []struct {
-			IssueID int64 `json:"issueID"`
-			Sorting int64 `json:"sorting"`
-		} `json:"issues"`
-	}
-
-	form := &movedIssuesForm{}
 	if err = json.NewDecoder(ctx.Req.Body).Decode(&form); err != nil {
 		ctx.ServerError("DecodeMovedIssuesForm", err)
 		return
@@ -576,7 +1007,7 @@ func MoveIssues(ctx *context.APIContext, model string) {
 		return
 	}
 
-	ctx.JSON(http.StatusOK, map[string]string{"message": "issues moved successfully"})
+	ctx.Status(http.StatusNoContent)
 }
 
 func getActionIssues(ctx *context.APIContext, issuesIDs []int64) issues_model.IssueList {
@@ -612,12 +1043,47 @@ func getActionIssues(ctx *context.APIContext, issuesIDs []int64) issues_model.Is
 
 // UpdateIssueProject change an issue's project
 func UpdateIssueProject(ctx *context.APIContext) {
-	type updateIssuesForm struct {
+	// swagger:operation POST /{username}/{repo}/{type}/projects project updateIssueProject
-		ProjectID int64   `json:"project_id"`
+	// ---
-		Issues    []int64 `json:"issues"`
+	// summary: Change an issue's project
-	}
+	// consumes:
+	// - application/json
+	// parameters:
+	// - name: username
+	//   in: path
+	//   description: owner of the project
+	//   required: true
+	//   type: string
+	// - name: repo
+	//   in: path
+	//   description: repository name.
+	//   required: true
+	//   type: string
+	// - name: type
+	//   in: path
+	//   description: issue type (issues or pulls)
+	//   required: true
+	//   type: string
+	//   enum:
+	//   - issues
+	//   - pulls
+	// - name: body
+	//   in: body
+	//   description: issues data
+	//   required: true
+	//   schema:
+	//    "$ref": "#/definitions/UpdateIssuesOption"
+	// responses:
+	//   "204":
+	//     "$ref": "#/responses/empty"
+	//   "403":
+	//     "$ref": "#/responses/forbidden"
+	//   "404":
+	//     "$ref": "#/responses/notFound"
+	//   "423":
+	//     "$ref": "#/responses/repoArchivedError"
 
-	form := &updateIssuesForm{}
+	form := &api.UpdateIssuesOption{}
 
 	if err := json.NewDecoder(ctx.Req.Body).Decode(&form); err != nil {
 		ctx.ServerError("DecodeMovedIssuesForm", err)
@@ -652,43 +1118,5 @@ func UpdateIssueProject(ctx *context.APIContext) {
 		}
 	}
 
-	ctx.JSON(http.StatusOK, map[string]string{"message": "issues moved successfully"})
+	ctx.Status(http.StatusNoContent)
-}
-
-// MoveColumns moves or keeps columns in a project and sorts them inside that project
-func MoveColumns(ctx *context.APIContext) {
-	project, err := project_model.GetProjectByID(ctx, ctx.PathParamInt64(":id"))
-	if err != nil {
-		ctx.NotFoundOrServerError("GetProjectByID", project_model.IsErrProjectNotExist, err)
-		return
-	}
-	if !project.CanBeAccessedByOwnerRepo(ctx.ContextUser.ID, ctx.Repo.Repository) {
-		ctx.NotFound("CanBeAccessedByOwnerRepo", nil)
-		return
-	}
-
-	type movedColumnsForm struct {
-		Columns []struct {
-			ColumnID int64 `json:"columnID"`
-			Sorting  int64 `json:"sorting"`
-		} `json:"columns"`
-	}
-
-	form := &movedColumnsForm{}
-	if err = json.NewDecoder(ctx.Req.Body).Decode(&form); err != nil {
-		ctx.ServerError("DecodeMovedColumnsForm", err)
-		return
-	}
-
-	sortedColumnIDs := make(map[int64]int64)
-	for _, column := range form.Columns {
-		sortedColumnIDs[column.Sorting] = column.ColumnID
-	}
-
-	if err = project_model.MoveColumnsOnProject(ctx, project, sortedColumnIDs); err != nil {
-		ctx.ServerError("MoveColumnsOnProject", err)
-		return
-	}
-
-	ctx.JSON(http.StatusOK, map[string]string{"message": "columns moved successfully"})
 }

routers/api/v1/swagger/options.go

@@ -208,4 +208,19 @@ type swaggerParameterBodies struct {
 
 	// in:body
 	CreateProjectOption api.CreateProjectOption
+
+	// in:body
+	CreateProjectColumnOption api.CreateProjectColumnOption
+
+	// in:body
+	EditProjectColumnOption api.EditProjectColumnOption
+
+	// in:body
+	MovedColumnsOption api.MovedColumnsOption
+
+	// in:body
+	MovedIssuesOption api.MovedIssuesOption
+
+	// in:body
+	UpdateIssuesOption api.UpdateIssuesOption
 }

routers/api/v1/swagger/project.go

@@ -13,3 +13,17 @@ type swaggerResponseProject struct {
 	// in:body
 	Body api.Project `json:"body"`
 }
+
+// ProjectList
+// swagger:response ProjectList
+type swaggerResponseProjectList struct {
+	// in:body
+	Body []api.Project `json:"body"`
+}
+
+// Column
+// swagger:response Column
+type swaggerResponseColumn struct {
+	// in:body
+	Body api.Column `json:"body"`
+}