embedded_spec.go

// Code generated by go-swagger; DO NOT EDIT.

package restapi

// This file was generated by the swagger tool.
// Editing this file might prove futile when you re-run the swagger generate command

import (
	"encoding/json"
)

var (
	// SwaggerJSON embedded version of the swagger document used at generation time
	SwaggerJSON json.RawMessage
	// FlatSwaggerJSON embedded flattened version of the swagger document used at generation time
	FlatSwaggerJSON json.RawMessage
)

func init() {
	SwaggerJSON = json.RawMessage([]byte(`{
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "swagger": "2.0",
  "info": {
    "description": "An API for 42 tutors.",
    "title": "42 Tutors API",
    "contact": {},
    "version": "0.0.1"
  },
  "basePath": "/v2",
  "paths": {
    "/auth/callback": {
      "get": {
        "description": "Authenticate a user with an authorization code.",
        "tags": [
          "Authentication"
        ],
        "summary": "Authenticate user",
        "operationId": "callback",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Token"
            }
          },
          "401": {
            "$ref": "#/responses/422"
          },
          "422": {
            "$ref": "#/responses/422"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/auth/login": {
      "get": {
        "description": "Login a user with redirection.",
        "tags": [
          "Authentication"
        ],
        "summary": "Login user",
        "operationId": "login",
        "responses": {
          "302": {
            "description": "Found"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/auth/token/info": {
      "get": {
        "description": "Send token information or unauthorized error response.",
        "tags": [
          "Authentication"
        ],
        "summary": "Send token information",
        "operationId": "tokenInfo",
        "parameters": [
          {
            "type": "string",
            "description": "Bearer access token",
            "name": "Authorization",
            "in": "header",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TokenInfo"
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/auth/token/refresh": {
      "get": {
        "description": "Refresh expired token.",
        "tags": [
          "Authentication"
        ],
        "summary": "Refresh token",
        "operationId": "tokenRefresh",
        "parameters": [
          {
            "type": "string",
            "description": "Bearer refresh token",
            "name": "Authorization",
            "in": "header",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Token"
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/events": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "List all events.",
        "tags": [
          "Event"
        ],
        "summary": "List events",
        "operationId": "listEvent",
        "parameters": [
          {
            "type": "string",
            "description": "From start day.",
            "name": "start",
            "in": "query"
          },
          {
            "type": "string",
            "description": "To end day.",
            "name": "end",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Create a new event.",
        "tags": [
          "Event"
        ],
        "summary": "Create event",
        "operationId": "createEvent",
        "parameters": [
          {
            "type": "integer",
            "description": "Event repetition count.",
            "name": "repeatCount",
            "in": "query"
          },
          {
            "enum": [
              "day",
              "week",
              "month"
            ],
            "type": "string",
            "description": "Event repetition type.",
            "name": "repeatType",
            "in": "query"
          },
          {
            "description": "Event to create.",
            "name": "event",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/Event"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/events/types": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event"
            ]
          }
        ],
        "description": "List all event categories.",
        "tags": [
          "EventType"
        ],
        "summary": "List event types",
        "operationId": "listType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/EventType"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Create a new event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Create event type",
        "operationId": "createType",
        "parameters": [
          {
            "description": "Event category to create.",
            "name": "type",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/events/types/{id}": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event"
            ]
          }
        ],
        "description": "Read an event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Read event type",
        "operationId": "readType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Update an event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Delete event type",
        "operationId": "deleteType",
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Update an event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Update event type",
        "operationId": "updateType",
        "parameters": [
          {
            "description": "Event category to update.",
            "name": "type",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "ID of event category.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/types/{id}/events/": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event"
            ]
          }
        ],
        "description": "List all events in a certain category.",
        "tags": [
          "EventType"
        ],
        "summary": "List event type events",
        "operationId": "listTypeEvents",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "ID of event category.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/users": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event"
            ]
          }
        ],
        "description": "List all events with all subscribed users.",
        "tags": [
          "Event"
        ],
        "summary": "List events with users.",
        "operationId": "listEventWithUsers",
        "parameters": [
          {
            "type": "string",
            "description": "From start day.",
            "name": "start",
            "in": "query"
          },
          {
            "type": "string",
            "description": "To end day.",
            "name": "end",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/events/{eventID}/types/{typeID}": {
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Set event type value.",
        "tags": [
          "Event"
        ],
        "summary": "Set event type",
        "operationId": "setEventType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "eventID",
          "in": "path",
          "required": true
        },
        {
          "type": "string",
          "description": "Category ID.",
          "name": "typeID",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/{id}": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event"
            ]
          }
        ],
        "description": "Read an event by ID.",
        "tags": [
          "Event"
        ],
        "summary": "Read event",
        "operationId": "readEvent",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Delete an event by ID.",
        "tags": [
          "Event"
        ],
        "summary": "Delete event",
        "operationId": "deleteEvent",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "event:write"
            ]
          }
        ],
        "description": "Update an event by ID.",
        "tags": [
          "Event"
        ],
        "summary": "Update event",
        "operationId": "updateEvent",
        "parameters": [
          {
            "description": "Event to update.",
            "name": "event",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/Event"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/{id}/types": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event"
            ]
          }
        ],
        "description": "Get event type value.",
        "tags": [
          "Event"
        ],
        "summary": "Get event type",
        "operationId": "getEventType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/{id}/users": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "event",
              "user"
            ]
          }
        ],
        "description": "List users subscribed to an event.",
        "tags": [
          "Event"
        ],
        "summary": "List event users",
        "operationId": "listEventUsers",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/User"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "List all users.",
        "tags": [
          "User"
        ],
        "summary": "List users",
        "operationId": "listUser",
        "parameters": [
          {
            "type": "boolean",
            "description": "Tutor filter.",
            "name": "tutor",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/User"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Create a new user.",
        "tags": [
          "User"
        ],
        "summary": "Create user",
        "operationId": "createUser",
        "parameters": [
          {
            "description": "User to create.",
            "name": "user",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/User"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/users/me": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "Read the authenticated user.",
        "tags": [
          "User"
        ],
        "summary": "Read authenticated user",
        "operationId": "readMe",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "Delete the authenticated user.",
        "tags": [
          "User"
        ],
        "summary": "Delete authenticated user",
        "operationId": "deleteMe",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "Update the authenticated user.",
        "tags": [
          "User"
        ],
        "summary": "Update authenticated user",
        "operationId": "updateMe",
        "parameters": [
          {
            "description": "User to update.",
            "name": "user",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/User"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/users/me/events": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "event"
            ]
          }
        ],
        "description": "List the authenticated user's subscribed events.",
        "tags": [
          "User"
        ],
        "summary": "List authenticated user events",
        "operationId": "listMeEvents",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/users/me/events/{id}": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:subscription",
              "event"
            ]
          }
        ],
        "description": "Subscribe an authenticated user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Subscribe authenticated user",
        "operationId": "subscribeMe",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:subscription",
              "event"
            ]
          }
        ],
        "description": "Unsubscribe an authenticated user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Unsubscribe authenticated user",
        "operationId": "unsubscribeMe",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/me/roles": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "List the authenticated user's roles.",
        "tags": [
          "User"
        ],
        "summary": "List authenticated user roles",
        "operationId": "listMeRoles",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/users/roles": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "List all roles.",
        "tags": [
          "Role"
        ],
        "summary": "List roles",
        "operationId": "listRole",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/401"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      }
    },
    "/users/{id}": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "Read an user by ID.",
        "tags": [
          "User"
        ],
        "summary": "Read user",
        "operationId": "readUser",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Delete an user by ID.",
        "tags": [
          "User"
        ],
        "summary": "Delete user",
        "operationId": "deleteUser",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Update an user by ID.",
        "tags": [
          "User"
        ],
        "summary": "Update user",
        "operationId": "updateUser",
        "parameters": [
          {
            "description": "User to update.",
            "name": "user",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/User"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/events": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "event"
            ]
          }
        ],
        "description": "List user's subscribed events.",
        "tags": [
          "User"
        ],
        "summary": "List user events",
        "operationId": "listUserEvents",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/role/admin": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Add admin role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Add admin",
        "operationId": "addAdmin",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Remove admin role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Remove admin",
        "operationId": "removeAdmin",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/role/calendar": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Add calendar role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Add calendar",
        "operationId": "addCalendar",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Remove calendar role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Remove calendar",
        "operationId": "removeCalendar",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/role/tutor": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Add tutor role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Add tutor",
        "operationId": "addTutor",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Remove tutor role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Remove tutor",
        "operationId": "removeTutor",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/roles": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "List the user's roles.",
        "tags": [
          "User"
        ],
        "summary": "List user roles",
        "operationId": "listUserRoles",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{userId}/events/{eventId}": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:subscription",
              "user:write",
              "event"
            ]
          }
        ],
        "description": "Subscribe a user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Subscribe user",
        "operationId": "subscribeUser",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:subscription",
              "user:write",
              "event"
            ]
          }
        ],
        "description": "Unsubscribe a user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Unsubscribe user",
        "operationId": "unsubscribeUser",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "$ref": "#/responses/400"
          },
          "401": {
            "$ref": "#/responses/401"
          },
          "403": {
            "$ref": "#/responses/403"
          },
          "404": {
            "$ref": "#/responses/404"
          },
          "500": {
            "$ref": "#/responses/500"
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "userId",
          "in": "path",
          "required": true
        },
        {
          "type": "string",
          "description": "Event ID.",
          "name": "eventId",
          "in": "path",
          "required": true
        }
      ]
    }
  },
  "definitions": {
    "Error": {
      "type": "object",
      "required": [
        "code",
        "status",
        "message"
      ],
      "properties": {
        "code": {
          "type": "integer",
          "example": 500
        },
        "message": {
          "type": "string",
          "example": "Explicit error message"
        },
        "status": {
          "type": "string",
          "example": "Internal Server Error"
        }
      }
    },
    "Event": {
      "type": "object",
      "required": [
        "createdAt",
        "endAt",
        "id",
        "name",
        "startAt"
      ],
      "properties": {
        "category": {
          "$ref": "#/definitions/EventType"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "description": {
          "type": "string"
        },
        "endAt": {
          "type": "string",
          "format": "date-time"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "startAt": {
          "type": "string",
          "format": "date-time"
        },
        "tutorsRequired": {
          "type": "integer",
          "format": "int64"
        },
        "users": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/User"
          }
        },
        "walletsReward": {
          "type": "integer",
          "format": "int64"
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "Event"
      }
    },
    "EventType": {
      "type": "object",
      "required": [
        "color",
        "id",
        "name"
      ],
      "properties": {
        "color": {
          "type": "string"
        },
        "events": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Event"
          }
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "EventType"
      }
    },
    "Role": {
      "type": "object",
      "required": [
        "event",
        "event_write",
        "id",
        "name",
        "user",
        "user_subscription",
        "user_write"
      ],
      "properties": {
        "event": {
          "type": "string"
        },
        "event_write": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "user": {
          "type": "string"
        },
        "user_subscription": {
          "type": "string"
        },
        "user_write": {
          "type": "string"
        },
        "users": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/User"
          }
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "Role"
      }
    },
    "Token": {
      "type": "object",
      "properties": {
        "accessToken": {
          "type": "string"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "issuedAt": {
          "type": "string",
          "format": "date-time"
        },
        "refreshToken": {
          "type": "string"
        }
      }
    },
    "TokenInfo": {
      "type": "object",
      "properties": {
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "issuedAt": {
          "type": "string",
          "format": "date-time"
        },
        "login": {
          "description": "username",
          "type": "string"
        },
        "roles": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "User": {
      "type": "object",
      "required": [
        "id",
        "login"
      ],
      "properties": {
        "displayName": {
          "type": "string"
        },
        "events": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Event"
          }
        },
        "firstName": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "imagePath": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "login": {
          "type": "string"
        },
        "roles": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Role"
          }
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "User"
      }
    },
    "principal": {
      "type": "string"
    }
  },
  "responses": {
    "400": {
      "description": "Bad request",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "401": {
      "description": "Unauthorized",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "403": {
      "description": "Forbidden",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "404": {
      "description": "Not Found",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "422": {
      "description": "Unprocessable Entity",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "500": {
      "description": "Internal Server Error",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    }
  },
  "securityDefinitions": {
    "OAuth2": {
      "type": "oauth2",
      "flow": "accessCode",
      "authorizationUrl": "https://api.intra.42.fr/oauth/authorize",
      "tokenUrl": "https://api.intra.42.fr/oauth/token",
      "scopes": {
        "event": "Read events",
        "event:write": "Read-write events",
        "public": "Public access",
        "user": "Read users",
        "user:subscription": "Subscribe to events",
        "user:write": "Read-write users"
      }
    }
  }
}`))
	FlatSwaggerJSON = json.RawMessage([]byte(`{
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "swagger": "2.0",
  "info": {
    "description": "An API for 42 tutors.",
    "title": "42 Tutors API",
    "contact": {},
    "version": "0.0.1"
  },
  "basePath": "/v2",
  "paths": {
    "/auth/callback": {
      "get": {
        "description": "Authenticate a user with an authorization code.",
        "tags": [
          "Authentication"
        ],
        "summary": "Authenticate user",
        "operationId": "callback",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Token"
            }
          },
          "401": {
            "description": "Unprocessable Entity",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/auth/login": {
      "get": {
        "description": "Login a user with redirection.",
        "tags": [
          "Authentication"
        ],
        "summary": "Login user",
        "operationId": "login",
        "responses": {
          "302": {
            "description": "Found"
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/auth/token/info": {
      "get": {
        "description": "Send token information or unauthorized error response.",
        "tags": [
          "Authentication"
        ],
        "summary": "Send token information",
        "operationId": "tokenInfo",
        "parameters": [
          {
            "type": "string",
            "description": "Bearer access token",
            "name": "Authorization",
            "in": "header",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TokenInfo"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/auth/token/refresh": {
      "get": {
        "description": "Refresh expired token.",
        "tags": [
          "Authentication"
        ],
        "summary": "Refresh token",
        "operationId": "tokenRefresh",
        "parameters": [
          {
            "type": "string",
            "description": "Bearer refresh token",
            "name": "Authorization",
            "in": "header",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Token"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/events": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "List all events.",
        "tags": [
          "Event"
        ],
        "summary": "List events",
        "operationId": "listEvent",
        "parameters": [
          {
            "type": "string",
            "description": "From start day.",
            "name": "start",
            "in": "query"
          },
          {
            "type": "string",
            "description": "To end day.",
            "name": "end",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "post": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Create a new event.",
        "tags": [
          "Event"
        ],
        "summary": "Create event",
        "operationId": "createEvent",
        "parameters": [
          {
            "type": "integer",
            "description": "Event repetition count.",
            "name": "repeatCount",
            "in": "query"
          },
          {
            "enum": [
              "day",
              "week",
              "month"
            ],
            "type": "string",
            "description": "Event repetition type.",
            "name": "repeatType",
            "in": "query"
          },
          {
            "description": "Event to create.",
            "name": "event",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/Event"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/events/types": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public"
            ]
          }
        ],
        "description": "List all event categories.",
        "tags": [
          "EventType"
        ],
        "summary": "List event types",
        "operationId": "listType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/EventType"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "post": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Create a new event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Create event type",
        "operationId": "createType",
        "parameters": [
          {
            "description": "Event category to create.",
            "name": "type",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/events/types/{id}": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public"
            ]
          }
        ],
        "description": "Read an event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Read event type",
        "operationId": "readType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Update an event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Delete event type",
        "operationId": "deleteType",
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Update an event category.",
        "tags": [
          "EventType"
        ],
        "summary": "Update event type",
        "operationId": "updateType",
        "parameters": [
          {
            "description": "Event category to update.",
            "name": "type",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "ID of event category.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/types/{id}/events/": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public"
            ]
          }
        ],
        "description": "List all events in a certain category.",
        "tags": [
          "EventType"
        ],
        "summary": "List event type events",
        "operationId": "listTypeEvents",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "ID of event category.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/users": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public"
            ]
          }
        ],
        "description": "List all events with all subscribed users.",
        "tags": [
          "Event"
        ],
        "summary": "List events with users.",
        "operationId": "listEventWithUsers",
        "parameters": [
          {
            "type": "string",
            "description": "From start day.",
            "name": "start",
            "in": "query"
          },
          {
            "type": "string",
            "description": "To end day.",
            "name": "end",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/events/{eventID}/types/{typeID}": {
      "patch": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Set event type value.",
        "tags": [
          "Event"
        ],
        "summary": "Set event type",
        "operationId": "setEventType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "eventID",
          "in": "path",
          "required": true
        },
        {
          "type": "string",
          "description": "Category ID.",
          "name": "typeID",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/{id}": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public"
            ]
          }
        ],
        "description": "Read an event by ID.",
        "tags": [
          "Event"
        ],
        "summary": "Read event",
        "operationId": "readEvent",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Delete an event by ID.",
        "tags": [
          "Event"
        ],
        "summary": "Delete event",
        "operationId": "deleteEvent",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "event",
              "event:write",
              "public"
            ]
          }
        ],
        "description": "Update an event by ID.",
        "tags": [
          "Event"
        ],
        "summary": "Update event",
        "operationId": "updateEvent",
        "parameters": [
          {
            "description": "Event to update.",
            "name": "event",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/Event"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/Event"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/{id}/types": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public"
            ]
          }
        ],
        "description": "Get event type value.",
        "tags": [
          "Event"
        ],
        "summary": "Get event type",
        "operationId": "getEventType",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/EventType"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/events/{id}/users": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user"
            ]
          }
        ],
        "description": "List users subscribed to an event.",
        "tags": [
          "Event"
        ],
        "summary": "List event users",
        "operationId": "listEventUsers",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/User"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "List all users.",
        "tags": [
          "User"
        ],
        "summary": "List users",
        "operationId": "listUser",
        "parameters": [
          {
            "type": "boolean",
            "description": "Tutor filter.",
            "name": "tutor",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/User"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Create a new user.",
        "tags": [
          "User"
        ],
        "summary": "Create user",
        "operationId": "createUser",
        "parameters": [
          {
            "description": "User to create.",
            "name": "user",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/User"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/users/me": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "Read the authenticated user.",
        "tags": [
          "User"
        ],
        "summary": "Read authenticated user",
        "operationId": "readMe",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "Delete the authenticated user.",
        "tags": [
          "User"
        ],
        "summary": "Delete authenticated user",
        "operationId": "deleteMe",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public"
            ]
          }
        ],
        "description": "Update the authenticated user.",
        "tags": [
          "User"
        ],
        "summary": "Update authenticated user",
        "operationId": "updateMe",
        "parameters": [
          {
            "description": "User to update.",
            "name": "user",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/User"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/users/me/events": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user"
            ]
          }
        ],
        "description": "List the authenticated user's subscribed events.",
        "tags": [
          "User"
        ],
        "summary": "List authenticated user events",
        "operationId": "listMeEvents",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/users/me/events/{id}": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user",
              "user:subscription"
            ]
          }
        ],
        "description": "Subscribe an authenticated user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Subscribe authenticated user",
        "operationId": "subscribeMe",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user",
              "user:subscription"
            ]
          }
        ],
        "description": "Unsubscribe an authenticated user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Unsubscribe authenticated user",
        "operationId": "unsubscribeMe",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "Event ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/me/roles": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "List the authenticated user's roles.",
        "tags": [
          "User"
        ],
        "summary": "List authenticated user roles",
        "operationId": "listMeRoles",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/users/roles": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "List all roles.",
        "tags": [
          "Role"
        ],
        "summary": "List roles",
        "operationId": "listRole",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      }
    },
    "/users/{id}": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "Read an user by ID.",
        "tags": [
          "User"
        ],
        "summary": "Read user",
        "operationId": "readUser",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Delete an user by ID.",
        "tags": [
          "User"
        ],
        "summary": "Delete user",
        "operationId": "deleteUser",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "patch": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Update an user by ID.",
        "tags": [
          "User"
        ],
        "summary": "Update user",
        "operationId": "updateUser",
        "parameters": [
          {
            "description": "User to update.",
            "name": "user",
            "in": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/User"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/User"
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/events": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user"
            ]
          }
        ],
        "description": "List user's subscribed events.",
        "tags": [
          "User"
        ],
        "summary": "List user events",
        "operationId": "listUserEvents",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/role/admin": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Add admin role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Add admin",
        "operationId": "addAdmin",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Remove admin role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Remove admin",
        "operationId": "removeAdmin",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/role/calendar": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Add calendar role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Add calendar",
        "operationId": "addCalendar",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Remove calendar role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Remove calendar",
        "operationId": "removeCalendar",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/role/tutor": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Add tutor role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Add tutor",
        "operationId": "addTutor",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user",
              "user:write"
            ]
          }
        ],
        "description": "Remove tutor role to a user.",
        "tags": [
          "Role"
        ],
        "summary": "Remove tutor",
        "operationId": "removeTutor",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{id}/roles": {
      "get": {
        "security": [
          {
            "OAuth2": [
              "public",
              "user"
            ]
          }
        ],
        "description": "List the user's roles.",
        "tags": [
          "User"
        ],
        "summary": "List user roles",
        "operationId": "listUserRoles",
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Role"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "id",
          "in": "path",
          "required": true
        }
      ]
    },
    "/users/{userId}/events/{eventId}": {
      "post": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user",
              "user:subscription",
              "user:write"
            ]
          }
        ],
        "description": "Subscribe a user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Subscribe user",
        "operationId": "subscribeUser",
        "responses": {
          "201": {
            "description": "Created",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Event"
              }
            }
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "delete": {
        "security": [
          {
            "OAuth2": [
              "event",
              "public",
              "user",
              "user:subscription",
              "user:write"
            ]
          }
        ],
        "description": "Unsubscribe a user to an event.",
        "tags": [
          "User"
        ],
        "summary": "Unsubscribe user",
        "operationId": "unsubscribeUser",
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "404": {
            "description": "Not Found",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          },
          "500": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/Error"
            }
          }
        }
      },
      "parameters": [
        {
          "type": "string",
          "description": "User ID.",
          "name": "userId",
          "in": "path",
          "required": true
        },
        {
          "type": "string",
          "description": "Event ID.",
          "name": "eventId",
          "in": "path",
          "required": true
        }
      ]
    }
  },
  "definitions": {
    "Error": {
      "type": "object",
      "required": [
        "code",
        "status",
        "message"
      ],
      "properties": {
        "code": {
          "type": "integer",
          "example": 500
        },
        "message": {
          "type": "string",
          "example": "Explicit error message"
        },
        "status": {
          "type": "string",
          "example": "Internal Server Error"
        }
      }
    },
    "Event": {
      "type": "object",
      "required": [
        "createdAt",
        "endAt",
        "id",
        "name",
        "startAt"
      ],
      "properties": {
        "category": {
          "$ref": "#/definitions/EventType"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "description": {
          "type": "string"
        },
        "endAt": {
          "type": "string",
          "format": "date-time"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "startAt": {
          "type": "string",
          "format": "date-time"
        },
        "tutorsRequired": {
          "type": "integer",
          "format": "int64"
        },
        "users": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/User"
          }
        },
        "walletsReward": {
          "type": "integer",
          "format": "int64"
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "Event"
      }
    },
    "EventType": {
      "type": "object",
      "required": [
        "color",
        "id",
        "name"
      ],
      "properties": {
        "color": {
          "type": "string"
        },
        "events": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Event"
          }
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "EventType"
      }
    },
    "Role": {
      "type": "object",
      "required": [
        "event",
        "event_write",
        "id",
        "name",
        "user",
        "user_subscription",
        "user_write"
      ],
      "properties": {
        "event": {
          "type": "string"
        },
        "event_write": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "user": {
          "type": "string"
        },
        "user_subscription": {
          "type": "string"
        },
        "user_write": {
          "type": "string"
        },
        "users": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/User"
          }
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "Role"
      }
    },
    "Token": {
      "type": "object",
      "properties": {
        "accessToken": {
          "type": "string"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "issuedAt": {
          "type": "string",
          "format": "date-time"
        },
        "refreshToken": {
          "type": "string"
        }
      }
    },
    "TokenInfo": {
      "type": "object",
      "properties": {
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "issuedAt": {
          "type": "string",
          "format": "date-time"
        },
        "login": {
          "description": "username",
          "type": "string"
        },
        "roles": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "User": {
      "type": "object",
      "required": [
        "id",
        "login"
      ],
      "properties": {
        "displayName": {
          "type": "string"
        },
        "events": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Event"
          }
        },
        "firstName": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "imagePath": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "login": {
          "type": "string"
        },
        "roles": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Role"
          }
        }
      },
      "x-go-type": {
        "import": {
          "package": "github.com/gmarcha/ent-goswagger-app/internal/ent"
        },
        "type": "User"
      }
    },
    "principal": {
      "type": "string"
    }
  },
  "responses": {
    "400": {
      "description": "Bad request",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "401": {
      "description": "Unauthorized",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "403": {
      "description": "Forbidden",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "404": {
      "description": "Not Found",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "422": {
      "description": "Unprocessable Entity",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    },
    "500": {
      "description": "Internal Server Error",
      "schema": {
        "$ref": "#/definitions/Error"
      }
    }
  },
  "securityDefinitions": {
    "OAuth2": {
      "type": "oauth2",
      "flow": "accessCode",
      "authorizationUrl": "https://api.intra.42.fr/oauth/authorize",
      "tokenUrl": "https://api.intra.42.fr/oauth/token",
      "scopes": {
        "event": "Read events",
        "event:write": "Read-write events",
        "public": "Public access",
        "user": "Read users",
        "user:subscription": "Subscribe to events",
        "user:write": "Read-write users"
      }
    }
  }
}`))
}