api-docs.json

{
  "openapi": "3.0.3",
  "info": {
    "title": "API docs for VClite",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://localhost:3000/api"
    }
  ],
  "paths": {
    "/registration": {
      "post": {
        "tags": ["account"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image": {
                    "type": "string",
                    "format": "base64-image-data-url"
                  },
                  "username": {
                    "type": "string",
                    "minLength": 1
                  },
                  "password": {
                    "type": "string",
                    "format": "password",
                    "minLength": 1
                  },
                  "email": {
                    "type": "string",
                    "format": "email"
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lastName": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": ["image", "username", "password", "email"]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Registration successful and account verification link was sent to provided email"
          },
          "400": {
            "description": "Registration data is invalid"
          },
          "422": {
            "description": "User with this username or email already exists"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/verification/{jwt}": {
      "get": {
        "tags": ["account"],
        "parameters": [
          {
            "in": "path",
            "name": "jwt",
            "required": true,
            "schema": {
              "type": "string",
              "format": "jwt"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Verification successful"
          },
          "400": {
            "description": "JWT is invalid"
          },
          "404": {
            "description": "User not found or already verified"
          },
          "422": {
            "description": "JWT is expired"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/login": {
      "post": {
        "tags": ["account"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "minLength": 1
                  },
                  "password": {
                    "type": "string",
                    "format": "password",
                    "minLength": 1
                  }
                },
                "required": ["username", "password"]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Login successful"
          },
          "400": {
            "description": "Login data is invalid"
          },
          "401": {
            "description": "User with this username not found or password is incorrect"
          },
          "403": {
            "description": "Account is not verified"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/users": {
      "post": {
        "tags": ["users"],
        "security": [{ "JWT": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image": {
                    "type": "string",
                    "format": "base64-image-data-url"
                  },
                  "username": {
                    "type": "string",
                    "minLength": 1
                  },
                  "password": {
                    "type": "string",
                    "format": "password",
                    "minLength": 1
                  },
                  "email": {
                    "type": "string",
                    "format": "email"
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lastName": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": ["image", "username", "password", "email"]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "User has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin"
          },
          "422": {
            "description": "User with this username or email already exists"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["users"],
        "security": [{ "JWT": [] }],
        "description": "Get info about the user assosiated with provided JWT",
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/users/{id}": {
      "delete": {
        "tags": ["users"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "User has been deleted"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or user not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/authors": {
      "post": {
        "tags": ["authors"],
        "security": [{ "JWT": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string",
                    "minLength": 1
                  },
                  "userId": {
                    "type": "integer",
                    "minimum": 1
                  }
                },
                "required": ["userId"]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Author has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "404": {
            "$ref": "#/components/responses/NotAdmin"
          },
          "422": {
            "description": "User with this id not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["authors"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/queryParameters/pageNumber"
          },
          {
            "$ref": "#/components/queryParameters/itemsNumber"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/InvalidPaginationQueryParameters"
          },
          "404": {
            "$ref": "#/components/responses/NotAdmin"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/authors/{id}": {
      "patch": {
        "tags": ["authors"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string",
                    "minLength": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Author has been updated"
          },
          "400": {
            "$ref": "#/components/responses/InvalidUpdateData"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or author not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "delete": {
        "tags": ["authors"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "Author has been deleted"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or author not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/tags": {
      "post": {
        "tags": ["tags"],
        "security": [{ "JWT": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": ["name"]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Tag has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "404": {
            "$ref": "#/components/responses/NotAdmin"
          },
          "422": {
            "description": "Tag with this name already exists"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["tags"],
        "parameters": [
          {
            "$ref": "#/components/queryParameters/pageNumber"
          },
          {
            "$ref": "#/components/queryParameters/itemsNumber"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/InvalidPaginationQueryParameters"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/tags/{id}": {
      "patch": {
        "tags": ["tags"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Tag has been updated"
          },
          "400": {
            "$ref": "#/components/responses/InvalidUpdateData"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or tag not found"
          },
          "422": {
            "description": "Tag with this name already exists"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "delete": {
        "tags": ["tags"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "Tag has been deleted"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or tag not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/categories": {
      "post": {
        "tags": ["categories"],
        "security": [{ "JWT": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1
                  },
                  "parentCategoryId": {
                    "type": "integer",
                    "minimum": 1
                  }
                },
                "required": ["name"]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Category has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "404": {
            "$ref": "#/components/responses/NotAdmin"
          },
          "422": {
            "description": "Category with this name already exists or parent category with this id not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["categories"],
        "parameters": [
          {
            "$ref": "#/components/queryParameters/pageNumber"
          },
          {
            "$ref": "#/components/queryParameters/itemsNumber"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/InvalidPaginationQueryParameters"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/categories/{id}": {
      "patch": {
        "tags": ["categories"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1
                  },
                  "parentCategoryId": {
                    "type": "integer",
                    "minimum": 1,
                    "nullable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Category has been updated"
          },
          "400": {
            "$ref": "#/components/responses/InvalidUpdateData"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or category not found"
          },
          "422": {
            "description": "Category with this name already exists or parent category with this id not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "delete": {
        "tags": ["categories"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "Category has been deleted"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or category not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/posts": {
      "post": {
        "tags": ["posts"],
        "security": [{ "JWT": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image": {
                    "type": "string",
                    "format": "base64-image-data-url"
                  },
                  "extraImages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "base64-image-data-url"
                    },
                    "minItems": 1
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "content": {
                    "type": "string",
                    "minLength": 1
                  },
                  "categoryId": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "tagIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1
                    },
                    "minItems": 1
                  }
                },
                "required": [
                  "image",
                  "title",
                  "content",
                  "categoryId",
                  "tagIds"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Post has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "403": {
            "$ref": "#/components/responses/NotAuthor"
          },
          "422": {
            "description": "Category with this id not found or some tag in provided array of tags ids not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["posts"],
        "parameters": [
          {
            "in": "query",
            "name": "titleContains",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "in": "query",
            "name": "contentContains",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "in": "query",
            "name": "authorFirstName",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "in": "query",
            "name": "categoryId",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "in": "query",
            "name": "tagId",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "in": "query",
            "name": "tagIdIn",
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 1
              },
              "minItems": 1
            }
          },
          {
            "in": "query",
            "name": "tagIdAll",
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 1
              },
              "minItems": 1
            }
          },
          {
            "in": "query",
            "name": "createdAt",
            "schema": {
              "type": "string",
              "format": "date",
              "minLength": 1
            }
          },
          {
            "in": "query",
            "name": "createdAtLt",
            "schema": {
              "type": "string",
              "format": "date",
              "minLength": 1
            }
          },
          {
            "in": "query",
            "name": "createdAtGt",
            "schema": {
              "type": "string",
              "format": "date",
              "minLength": 1
            }
          },
          {
            "$ref": "#/components/queryParameters/pageNumber"
          },
          {
            "$ref": "#/components/queryParameters/itemsNumber"
          },
          {
            "in": "query",
            "name": "orderBy",
            "schema": {
              "type": "string",
              "enum": [
                "createdAt",
                "-createdAt",
                "authorFirstName",
                "-authorFirstName",
                "categoryName",
                "-categoryName",
                "imagesNumber",
                "-imagesNumber"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Invalid filter, pagination or order query parameters"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/posts/{id}": {
      "patch": {
        "tags": ["posts"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image": {
                    "type": "string",
                    "format": "base64-image-data-url"
                  },
                  "extraImages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "base64-image-data-url"
                    },
                    "minItems": 1
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "content": {
                    "type": "string",
                    "minLength": 1
                  },
                  "categoryId": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "tagIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1
                    },
                    "minItems": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Post has been updated"
          },
          "400": {
            "$ref": "#/components/responses/InvalidUpdateData"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or post not found"
          },
          "422": {
            "description": "Category with this id not found or some tag in provided array of tags ids not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "delete": {
        "tags": ["posts"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "Post has been deleted"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or post not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/posts/{id}/comments": {
      "post": {
        "tags": ["post's comments"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": ["content"]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Comment has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "404": {
            "description": "Post not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["post's comments"],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          },
          {
            "$ref": "#/components/queryParameters/pageNumber"
          },
          {
            "$ref": "#/components/queryParameters/itemsNumber"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/InvalidPaginationQueryParameters"
          },
          "404": {
            "description": "Post not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "delete": {
        "tags": ["post's comments"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "Comments have been deleted"
          },
          "404": {
            "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin or post not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/drafts": {
      "post": {
        "tags": ["drafts"],
        "security": [{ "JWT": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image": {
                    "type": "string",
                    "format": "base64-image-data-url"
                  },
                  "extraImages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "base64-image-data-url"
                    },
                    "minItems": 1
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "content": {
                    "type": "string",
                    "minLength": 1
                  },
                  "categoryId": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "tagIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1
                    },
                    "minItems": 1
                  }
                },
                "required": [
                  "image",
                  "title",
                  "content",
                  "categoryId",
                  "tagIds"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Draft has been created"
          },
          "400": {
            "$ref": "#/components/responses/InvalidCreationData"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "403": {
            "$ref": "#/components/responses/NotAuthor"
          },
          "422": {
            "description": "Category with this id not found or some tag in provided array of tags ids not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "get": {
        "tags": ["drafts"],
        "description": "Get author's drafts",
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/queryParameters/pageNumber"
          },
          {
            "$ref": "#/components/queryParameters/itemsNumber"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/InvalidPaginationQueryParameters"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "403": {
            "$ref": "#/components/responses/NotAuthor"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/drafts/{id}": {
      "patch": {
        "tags": ["drafts"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image": {
                    "type": "string",
                    "format": "base64-image-data-url"
                  },
                  "extraImages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "base64-image-data-url"
                    },
                    "minItems": 1
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "content": {
                    "type": "string",
                    "minLength": 1
                  },
                  "categoryId": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "tagIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1
                    },
                    "minItems": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Draft has been updated"
          },
          "400": {
            "$ref": "#/components/responses/InvalidUpdateData"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "403": {
            "$ref": "#/components/responses/NotAuthor"
          },
          "404": {
            "description": "Draft not found"
          },
          "422": {
            "description": "Category with this id not found or some tag in provided array of tags ids not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      },
      "delete": {
        "tags": ["drafts"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "204": {
            "description": "Draft has been deleted"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "403": {
            "$ref": "#/components/responses/NotAuthor"
          },
          "404": {
            "description": "Draft not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    },
    "/drafts/{id}/publish": {
      "post": {
        "tags": ["drafts"],
        "security": [{ "JWT": [] }],
        "parameters": [
          {
            "$ref": "#/components/pathParameters/id"
          }
        ],
        "responses": {
          "201": {
            "description": "Draft has been published"
          },
          "401": {
            "$ref": "#/components/responses/Unauthenticated"
          },
          "403": {
            "$ref": "#/components/responses/NotAuthor"
          },
          "404": {
            "description": "Draft not found"
          },
          "500": {
            "$ref": "#/components/responses/UnknownError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "JWT": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "pathParameters": {
      "id": {
        "in": "path",
        "name": "id",
        "required": true,
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      }
    },
    "queryParameters": {
      "pageNumber": {
        "in": "query",
        "name": "pageNumber",
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      },
      "itemsNumber": {
        "in": "query",
        "name": "itemsNumber",
        "schema": {
          "type": "integer",
          "minimum": 1
        }
      }
    },
    "responses": {
      "NotAdmin": {
        "description": "JWT isn't provided or invalid/expired or authenticated user isn't an admin"
      },
      "NotAuthor": {
        "description": "Authenticated user isn't an author"
      },
      "InvalidCreationData": {
        "description": "Creation data is invalid"
      },
      "InvalidUpdateData": {
        "description": "Update data is invalid"
      },
      "InvalidPaginationQueryParameters": {
        "description": "Pagination query parameters are invalid"
      },
      "Unauthenticated": {
        "description": "JWT isn't provided or invalid/expired"
      },
      "UnknownError": {
        "description": "Unknown error. Please contact [oleg@oleg.ru](mailto:oleg@oleg.ru)"
      }
    }
  }
}