forked from vikunja/vikunja
renovate
0ca1560bf1
Co-authored-by: kolaente <k@knt.li> Reviewed-on: vikunja/api#990 Co-authored-by: renovate <renovatebot@kolaente.de> Co-committed-by: renovate <renovatebot@kolaente.de>
9175 lines
340 KiB
Go
9175 lines
340 KiB
Go
// Package swagger GENERATED BY THE COMMAND ABOVE; DO NOT EDIT
|
|
// This file was generated by swaggo/swag
|
|
package swagger
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/json"
|
|
"strings"
|
|
"text/template"
|
|
|
|
"github.com/swaggo/swag"
|
|
)
|
|
|
|
var doc = `{
|
|
"schemes": {{ marshal .Schemes }},
|
|
"swagger": "2.0",
|
|
"info": {
|
|
"description": "{{escape .Description}}",
|
|
"title": "{{.Title}}",
|
|
"contact": {
|
|
"name": "General Vikunja contact",
|
|
"url": "http://vikunja.io/en/contact/",
|
|
"email": "hello@vikunja.io"
|
|
},
|
|
"license": {
|
|
"name": "GPLv3",
|
|
"url": "http://code.vikunja.io/api/src/branch/master/LICENSE"
|
|
},
|
|
"version": "{{.Version}}"
|
|
},
|
|
"host": "{{.Host}}",
|
|
"basePath": "{{.BasePath}}",
|
|
"paths": {
|
|
"/auth/openid/{provider}/callback": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "After a redirect from the OpenID Connect provider to the frontend has been made with the authentication ` + "`" + `code` + "`" + `, this endpoint can be used to obtain a jwt token for that user and thus log them in.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"auth"
|
|
],
|
|
"summary": "Authenticate a user with OpenID Connect",
|
|
"parameters": [
|
|
{
|
|
"description": "The openid callback",
|
|
"name": "callback",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/openid.Callback"
|
|
}
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The OpenID Connect provider key as returned by the /info endpoint",
|
|
"name": "provider",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "OK",
|
|
"schema": {
|
|
"$ref": "#/definitions/auth.Token"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/backgrounds/unsplash/image/{image}": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Get an unsplash image. **Returns json on error.**",
|
|
"produces": [
|
|
"application/octet-stream"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Get an unsplash image",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Unsplash Image ID",
|
|
"name": "thumb",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The image",
|
|
"schema": {
|
|
"type": ""
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The image does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/backgrounds/unsplash/image/{image}/thumb": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Get an unsplash thumbnail image. The thumbnail is cropped to a max width of 200px. **Returns json on error.**",
|
|
"produces": [
|
|
"application/octet-stream"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Get an unsplash thumbnail image",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Unsplash Image ID",
|
|
"name": "thumb",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The thumbnail",
|
|
"schema": {
|
|
"type": ""
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The image does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/backgrounds/unsplash/search": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Search for a list background from unsplash",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Search for a background from unsplash",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "Search backgrounds from unsplash with this search term.",
|
|
"name": "s",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "p",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "An array with photos",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/background.Image"
|
|
}
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/filters": {
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Creates a new saved filter",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"filter"
|
|
],
|
|
"summary": "Creates a new saved filter",
|
|
"responses": {
|
|
"201": {
|
|
"description": "The Saved Filter",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.SavedFilter"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to that saved filter.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/filters/{id}": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns a saved filter by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"filter"
|
|
],
|
|
"summary": "Gets one saved filter",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Filter ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The Saved Filter",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.SavedFilter"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to that saved filter.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Updates a saved filter by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"filter"
|
|
],
|
|
"summary": "Updates a saved filter",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Filter ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The Saved Filter",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.SavedFilter"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to that saved filter.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The saved filter does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Removes a saved filter by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"filter"
|
|
],
|
|
"summary": "Removes a saved filter",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Filter ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The Saved Filter",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.SavedFilter"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to that saved filter.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The saved filter does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/info": {
|
|
"get": {
|
|
"description": "Returns the version, frontendurl, motd and various settings of Vikunja",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"service"
|
|
],
|
|
"summary": "Info",
|
|
"responses": {
|
|
"200": {
|
|
"description": "OK",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1.vikunjaInfos"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/labels": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns all labels which are either created by the user or associated with a task the user has at least read-access to.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"labels"
|
|
],
|
|
"summary": "Get all labels a user has access to",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search labels by label text.",
|
|
"name": "s",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The labels",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Creates a new label.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"labels"
|
|
],
|
|
"summary": "Create a label",
|
|
"parameters": [
|
|
{
|
|
"description": "The label object",
|
|
"name": "label",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created label object.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid label object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/labels/{id}": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns one label by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"labels"
|
|
],
|
|
"summary": "Gets one label",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Label ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The label",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the label",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Label not found",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Update an existing label. The user needs to be the creator of the label to be able to do this.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"labels"
|
|
],
|
|
"summary": "Update a label",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Label ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The label object",
|
|
"name": "label",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The created label object.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid label object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "Not allowed to update the label.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Label not found.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Delete an existing label. The user needs to be the creator of the label to be able to do this.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"labels"
|
|
],
|
|
"summary": "Delete a label",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Label ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The label was successfully deleted.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Label"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "Not allowed to delete the label.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Label not found.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns all lists a user has access to.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Get all lists a user has access to",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search lists by title.",
|
|
"name": "s",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "boolean",
|
|
"description": "If true, also returns all archived lists.",
|
|
"name": "is_archived",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The lists",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.List"
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns a list by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Gets one list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The list",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.List"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Inserts a task into a list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"task"
|
|
],
|
|
"summary": "Create a task",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The task object",
|
|
"name": "task",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Task"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created task object.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Task"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid task object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Updates a list. This does not include adding a task (see below).",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Updates a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The list with updated values you want to update.",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.List"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The updated list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.List"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid list object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Delets a list",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Deletes a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The list was successfully deleted.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid list object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/background": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Get the list background of a specific list. **Returns json on error.**",
|
|
"produces": [
|
|
"application/octet-stream"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Get the list background",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The list background file.",
|
|
"schema": {
|
|
"type": ""
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "No access to this list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Removes a previously set list background, regardless of the list provider used to set the background. It does not throw an error if the list does not have a background.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Remove a list background",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The list",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.List"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "No access to this list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/backgrounds/unsplash": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Sets a photo from unsplash as list background.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Set an unsplash photo as list background",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The image you want to set as background",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/background.Image"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The background has been successfully set.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.List"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid image object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/backgrounds/upload": {
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Upload a list background.",
|
|
"consumes": [
|
|
"multipart/form-data"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Upload a list background",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The file as single file.",
|
|
"name": "background",
|
|
"in": "formData",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The background was set successfully.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "File is no image.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "File too large.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/buckets": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns all kanban buckets with belong to a list including their tasks.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"task"
|
|
],
|
|
"summary": "Get all kanban buckets of a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List Id",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number for tasks. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of tasks per bucket per page. This parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search tasks by task text.",
|
|
"name": "s",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The name of the field to filter by. Allowed values are all task properties. Task properties which are their own object require passing in the id of that entity. Accepts an array for multiple filters which will be chanied together, all supplied filter must match.",
|
|
"name": "filter_by",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The value to filter for.",
|
|
"name": "filter_value",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The comparator to use for a filter. Available values are ` + "`" + `equals` + "`" + `, ` + "`" + `greater` + "`" + `, ` + "`" + `greater_equals` + "`" + `, ` + "`" + `less` + "`" + `, ` + "`" + `less_equals` + "`" + `, ` + "`" + `like` + "`" + ` and ` + "`" + `in` + "`" + `. ` + "`" + `in` + "`" + ` expects comma-separated values in ` + "`" + `filter_value` + "`" + `. Defaults to ` + "`" + `equals` + "`" + `",
|
|
"name": "filter_comparator",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The concatinator to use for filters. Available values are ` + "`" + `and` + "`" + ` or ` + "`" + `or` + "`" + `. Defaults to ` + "`" + `or` + "`" + `.",
|
|
"name": "filter_concat",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "If set to true the result will include filtered fields whose value is set to ` + "`" + `null` + "`" + `. Available values are ` + "`" + `true` + "`" + ` or ` + "`" + `false` + "`" + `. Defaults to ` + "`" + `false` + "`" + `.",
|
|
"name": "filter_include_nulls",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The buckets with their tasks",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.Bucket"
|
|
}
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Creates a new kanban bucket on a list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"task"
|
|
],
|
|
"summary": "Create a new bucket",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List Id",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The bucket object",
|
|
"name": "bucket",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Bucket"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The created bucket object.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Bucket"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid bucket object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/listusers": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Lists all users (without emailadresses). Also possible to search for a specific user.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Get users",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "Search for a user by its name.",
|
|
"name": "s",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "All (found) users.",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/user.User"
|
|
}
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Something's invalid.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"401": {
|
|
"description": "The user does not have the right to see the list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/teams": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns a list with all teams which have access on a given list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Get teams on a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search teams by its name.",
|
|
"name": "s",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The teams with their right.",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.TeamWithRight"
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "No right to see the list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Gives a team access to a list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Add a team to a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The team you want to add to the list.",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.TeamList"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created team\u003c-\u003elist relation.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.TeamList"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid team list object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The team does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{id}/users": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns a list with all users which have access on a given list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Get users on a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search users by its name.",
|
|
"name": "s",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The users with the right they have.",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.UserWithRight"
|
|
}
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "No right to see the list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Gives a user access to a list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Add a user to a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The user you want to add to the list.",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.ListUser"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created user\u003c-\u003elist relation.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.ListUser"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid user list object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The user does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{listID}/buckets/{bucketID}": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Updates an existing kanban bucket.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"task"
|
|
],
|
|
"summary": "Update an existing bucket",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List Id",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "Bucket Id",
|
|
"name": "bucketID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The bucket object",
|
|
"name": "bucket",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Bucket"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The created bucket object.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Bucket"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid bucket object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The bucket does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Deletes an existing kanban bucket and dissociates all of its task. It does not delete any tasks. You cannot delete the last bucket on a list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"task"
|
|
],
|
|
"summary": "Deletes an existing bucket",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List Id",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "Bucket Id",
|
|
"name": "bucketID",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successfully deleted.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The bucket does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{listID}/duplicate": {
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Copies the list, tasks, files, kanban data, assignees, comments, attachments, lables, relations, backgrounds, user/team rights and link shares from one list to a new namespace. The user needs read access in the list and write access in the namespace of the new list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"list"
|
|
],
|
|
"summary": "Duplicate an existing list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "The list ID to duplicate",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The target namespace which should hold the copied list.",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.ListDuplicate"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.ListDuplicate"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid list duplicate object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list or namespace",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{listID}/tasks": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns all tasks for the current list.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"task"
|
|
],
|
|
"summary": "Get tasks in a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "The list ID.",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search tasks by task text.",
|
|
"name": "s",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The sorting parameter. You can pass this multiple times to get the tasks ordered by multiple different parametes, along with ` + "`" + `order_by` + "`" + `. Possible values to sort by are ` + "`" + `id` + "`" + `, ` + "`" + `title` + "`" + `, ` + "`" + `description` + "`" + `, ` + "`" + `done` + "`" + `, ` + "`" + `done_at` + "`" + `, ` + "`" + `due_date` + "`" + `, ` + "`" + `created_by_id` + "`" + `, ` + "`" + `list_id` + "`" + `, ` + "`" + `repeat_after` + "`" + `, ` + "`" + `priority` + "`" + `, ` + "`" + `start_date` + "`" + `, ` + "`" + `end_date` + "`" + `, ` + "`" + `hex_color` + "`" + `, ` + "`" + `percent_done` + "`" + `, ` + "`" + `uid` + "`" + `, ` + "`" + `created` + "`" + `, ` + "`" + `updated` + "`" + `. Default is ` + "`" + `id` + "`" + `.",
|
|
"name": "sort_by",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The ordering parameter. Possible values to order by are ` + "`" + `asc` + "`" + ` or ` + "`" + `desc` + "`" + `. Default is ` + "`" + `asc` + "`" + `.",
|
|
"name": "order_by",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The name of the field to filter by. Allowed values are all task properties. Task properties which are their own object require passing in the id of that entity. Accepts an array for multiple filters which will be chanied together, all supplied filter must match.",
|
|
"name": "filter_by",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The value to filter for.",
|
|
"name": "filter_value",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The comparator to use for a filter. Available values are ` + "`" + `equals` + "`" + `, ` + "`" + `greater` + "`" + `, ` + "`" + `greater_equals` + "`" + `, ` + "`" + `less` + "`" + `, ` + "`" + `less_equals` + "`" + `, ` + "`" + `like` + "`" + ` and ` + "`" + `in` + "`" + `. ` + "`" + `in` + "`" + ` expects comma-separated values in ` + "`" + `filter_value` + "`" + `. Defaults to ` + "`" + `equals` + "`" + `",
|
|
"name": "filter_comparator",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "The concatinator to use for filters. Available values are ` + "`" + `and` + "`" + ` or ` + "`" + `or` + "`" + `. Defaults to ` + "`" + `or` + "`" + `.",
|
|
"name": "filter_concat",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "If set to true the result will include filtered fields whose value is set to ` + "`" + `null` + "`" + `. Available values are ` + "`" + `true` + "`" + ` or ` + "`" + `false` + "`" + `. Defaults to ` + "`" + `false` + "`" + `.",
|
|
"name": "filter_include_nulls",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The tasks",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.Task"
|
|
}
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{listID}/teams/{teamID}": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Update a team \u003c-\u003e list relation. Mostly used to update the right that team has.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Update a team \u003c-\u003e list relation",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "Team ID",
|
|
"name": "teamID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The team you want to update.",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.TeamList"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The updated team \u003c-\u003e list relation.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.TeamList"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have admin-access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Team or list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Delets a team from a list. The team won't have access to the list anymore.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Delete a team from a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "Team ID",
|
|
"name": "teamID",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The team was successfully deleted.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Team or list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{listID}/users/{userID}": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Update a user \u003c-\u003e list relation. Mostly used to update the right that user has.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Update a user \u003c-\u003e list relation",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "User ID",
|
|
"name": "userID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The user you want to update.",
|
|
"name": "list",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.ListUser"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The updated user \u003c-\u003e list relation.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.ListUser"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have admin-access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "User or list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Delets a user from a list. The user won't have access to the list anymore.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Delete a user from a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "listID",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "User ID",
|
|
"name": "userID",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The user was successfully removed from the list.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "user or list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{list}/shares": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns all link shares which exist for a given list",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Get all link shares for a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "list",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search shares by hash.",
|
|
"name": "s",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The share links",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.LinkSharing"
|
|
}
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Share a list via link. The user needs to have write-access to the list to be able do this.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Share a list via link",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "list",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The new link share object",
|
|
"name": "label",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.LinkSharing"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created link share object.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.LinkSharing"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid link share object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "Not allowed to add the list share.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "The list does not exist.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/lists/{list}/shares/{share}": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns one link share by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Get one link shares for a list",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "list",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "Share ID",
|
|
"name": "share",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The share links",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.LinkSharing"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "No access to the list",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Share Link not found.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Remove a link share. The user needs to have write-access to the list to be able do this.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"sharing"
|
|
],
|
|
"summary": "Remove a link share",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "List ID",
|
|
"name": "list",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "Share Link ID",
|
|
"name": "share",
|
|
"in": "path",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The link was successfully removed.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "Not allowed to remove the link.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"404": {
|
|
"description": "Share Link not found.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/login": {
|
|
"post": {
|
|
"description": "Logs a user in. Returns a JWT-Token to authenticate further requests.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"user"
|
|
],
|
|
"summary": "Login",
|
|
"parameters": [
|
|
{
|
|
"description": "The login credentials",
|
|
"name": "credentials",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/user.Login"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "OK",
|
|
"schema": {
|
|
"$ref": "#/definitions/auth.Token"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid user password model.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "Invalid username or password.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"412": {
|
|
"description": "Invalid totp passcode.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/microsoft-todo/auth": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from Microsoft Todo to Vikunja.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get the auth url from Microsoft Todo",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The auth url.",
|
|
"schema": {
|
|
"$ref": "#/definitions/handler.AuthURL"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/microsoft-todo/migrate": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Migrates all tasklinsts, tasks, notes and reminders from Microsoft Todo to Vikunja.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Migrate all lists, tasks etc. from Microsoft Todo",
|
|
"parameters": [
|
|
{
|
|
"description": "The auth token previously obtained from the auth url. See the docs for /migration/microsoft-todo/auth.",
|
|
"name": "migrationCode",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/microsofttodo.Migration"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "A message telling you everything was migrated successfully.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/microsoft-todo/status": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get migration status",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The migration status",
|
|
"schema": {
|
|
"$ref": "#/definitions/migration.Status"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/todoist/auth": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from todoist to Vikunja.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get the auth url from todoist",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The auth url.",
|
|
"schema": {
|
|
"$ref": "#/definitions/handler.AuthURL"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/todoist/migrate": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Migrates all projects, tasks, notes, reminders, subtasks and files from todoist to vikunja.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Migrate all lists, tasks etc. from todoist",
|
|
"parameters": [
|
|
{
|
|
"description": "The auth code previously obtained from the auth url. See the docs for /migration/todoist/auth.",
|
|
"name": "migrationCode",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/todoist.Migration"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "A message telling you everything was migrated successfully.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/todoist/status": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get migration status",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The migration status",
|
|
"schema": {
|
|
"$ref": "#/definitions/migration.Status"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/trello/auth": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from trello to Vikunja.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get the auth url from trello",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The auth url.",
|
|
"schema": {
|
|
"$ref": "#/definitions/handler.AuthURL"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/trello/migrate": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Migrates all projects, tasks, notes, reminders, subtasks and files from trello to vikunja.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Migrate all lists, tasks etc. from trello",
|
|
"parameters": [
|
|
{
|
|
"description": "The auth token previously obtained from the auth url. See the docs for /migration/trello/auth.",
|
|
"name": "migrationCode",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/trello.Migration"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "A message telling you everything was migrated successfully.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/trello/status": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get migration status",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The migration status",
|
|
"schema": {
|
|
"$ref": "#/definitions/migration.Status"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/vikunja-file/migrate": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Imports all projects, tasks, notes, reminders, subtasks and files from a Vikunjda data export into Vikunja.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Import all lists, tasks etc. from a Vikunja data export",
|
|
"parameters": [
|
|
{
|
|
"type": "string",
|
|
"description": "The Vikunja export zip file.",
|
|
"name": "import",
|
|
"in": "formData",
|
|
"required": true
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "A message telling you everything was migrated successfully.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/vikunja-file/status": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get migration status",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The migration status",
|
|
"schema": {
|
|
"$ref": "#/definitions/migration.Status"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/wunderlist/auth": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from wunderlist to Vikunja.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get the auth url from wunderlist",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The auth url.",
|
|
"schema": {
|
|
"$ref": "#/definitions/handler.AuthURL"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/wunderlist/migrate": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Migrates all folders, lists, tasks, notes, reminders, subtasks and files from wunderlist to vikunja.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Migrate all lists, tasks etc. from wunderlist",
|
|
"parameters": [
|
|
{
|
|
"description": "The auth code previously obtained from the auth url. See the docs for /migration/wunderlist/auth.",
|
|
"name": "migrationCode",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/wunderlist.Migration"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "A message telling you everything was migrated successfully.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/migration/wunderlist/status": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again.",
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"migration"
|
|
],
|
|
"summary": "Get migration status",
|
|
"responses": {
|
|
"200": {
|
|
"description": "The migration status",
|
|
"schema": {
|
|
"$ref": "#/definitions/migration.Status"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal server error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/namespace/{id}": {
|
|
"post": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Updates a namespace.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"namespace"
|
|
],
|
|
"summary": "Updates a namespace",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "Namespace ID",
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true
|
|
},
|
|
{
|
|
"description": "The namespace with updated values you want to update.",
|
|
"name": "namespace",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Namespace"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The updated namespace.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Namespace"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid namespace object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the namespace",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/namespaces": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns all namespaces a user has access to.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"namespace"
|
|
],
|
|
"summary": "Get all namespaces a user has access to",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|
"description": "The page number. Used for pagination. If not provided, the first page of results is returned.",
|
|
"name": "page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "integer",
|
|
"description": "The maximum number of items per page. Note this parameter is limited by the configured maximum of items per page.",
|
|
"name": "per_page",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "string",
|
|
"description": "Search namespaces by name.",
|
|
"name": "s",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "boolean",
|
|
"description": "If true, also returns all archived namespaces.",
|
|
"name": "is_archived",
|
|
"in": "query"
|
|
},
|
|
{
|
|
"type": "boolean",
|
|
"description": "If true, also returns only namespaces without their lists.",
|
|
"name": "namespaces_only",
|
|
"in": "query"
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "The Namespaces.",
|
|
"schema": {
|
|
"type": "array",
|
|
"items": {
|
|
"$ref": "#/definitions/models.NamespaceWithLists"
|
|
}
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"put": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Creates a new namespace.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"namespace"
|
|
],
|
|
"summary": "Creates a new namespace",
|
|
"parameters": [
|
|
{
|
|
"description": "The namespace you want to create.",
|
|
"name": "namespace",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Namespace"
|
|
}
|
|
}
|
|
],
|
|
"responses": {
|
|
"201": {
|
|
"description": "The created namespace.",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Namespace"
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid namespace object provided.",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"403": {
|
|
"description": "The user does not have access to the namespace",
|
|
"schema": {
|
|
"$ref": "#/definitions/web.HTTPError"
|
|
}
|
|
},
|
|
"500": {
|
|
"description": "Internal error",
|
|
"schema": {
|
|
"$ref": "#/definitions/models.Message"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/namespaces/{id}": {
|
|
"get": {
|
|
"security": [
|
|
{
|
|
"JWTKeyAuth": []
|
|
}
|
|
],
|
|
"description": "Returns a namespace by its ID.",
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"tags": [
|
|
"namespace"
|
|
],
|
|
"summary": "Gets one namespace",
|
|
"parameters": [
|
|
{
|
|
"type": "integer",
|
|