{
  "openapi": "3.0.0",
  "info": {
    "title": "Projects API",
    "version": "1.0.0",
    "description": "RESTful API for managing Projects and Collections",
    "termsOfService": "https://readcoop.eu/terms-and-conditions/",
    "contact": {
      "name": "API Support",
      "email": "info@readcoop.eu",
      "url": "https://readcoop.eu"
    },
    "license": {
      "name": "ISC",
      "url": "https://opensource.org/licenses/ISC"
    }
  },
  "servers": [
    {
      "url": "https://projects-api.transkribus.org",
      "description": "Production server"
    }
  ],
  "components": {
    "securitySchemes": {
      "oAuth2AuthCode": {
        "type": "oauth2",
        "description": "READCOOP SSO",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "undefined/realms/readcoop/protocol/openid-connect/auth",
            "tokenUrl": "undefined/realms/readcoop/protocol/openid-connect/token",
            "refreshUrl": "undefined/realms/readcoop/protocol/openid-connect/token",
            "scopes": {
              "openid": "standard scope"
            },
            "clientId": "subscription-api-client-swagger"
          }
        }
      }
    },
    "schemas": {
      "Project": {
        "type": "object",
        "required": [
          "name",
          "ownerId",
          "organizationId"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "maxLength": 255
          },
          "description": {
            "type": "string"
          },
          "ownerId": {
            "type": "string",
            "format": "uuid"
          },
          "organizationId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "archived",
              "deleted"
            ]
          },
          "visibility": {
            "type": "string",
            "enum": [
              "private",
              "public",
              "organisation"
            ],
            "default": "private"
          },
          "imageUrl": {
            "type": "string",
            "format": "uri",
            "description": "URL to project image/thumbnail"
          },
          "country": {
            "type": "string",
            "description": "Country related to the documents in this project"
          },
          "city": {
            "type": "string",
            "description": "City related to the documents in this project"
          },
          "fromYear": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9999,
            "description": "Start year of the time period covered by documents"
          },
          "toYear": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9999,
            "description": "End year of the time period covered by documents"
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Languages used in the documents (can be multiple)"
          },
          "institution": {
            "type": "string",
            "description": "Institution or archive that provided/owns the documents"
          },
          "documentType": {
            "type": "string",
            "description": "Type of documents (e.g., letters, ledgers, registers)"
          },
          "settings": {
            "type": "object"
          },
          "metadata": {
            "type": "object"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "ProjectCollection": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "format": "uuid"
          },
          "collectionId": {
            "type": "string",
            "format": "uuid",
            "description": "Reference to collection in Transkribus API"
          },
          "addedBy": {
            "type": "string",
            "format": "uuid"
          },
          "metadata": {
            "type": "object"
          },
          "collection": {
            "type": "object",
            "description": "Collection data from Transkribus API"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    }
  },
  "security": [
    {
      "oAuth2AuthCode": [
        "openid"
      ]
    }
  ],
  "paths": {
    "/v1/projects/{id}/join": {
      "post": {
        "summary": "Join a public project (auto-join or submit join request)",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "message": {
                    "type": "string",
                    "description": "Optional message for join request (only used when joinMode is 'join_request')"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfully joined or request submitted"
          },
          "400": {
            "description": "Already a member or pending request exists"
          },
          "403": {
            "description": "Project is not public"
          }
        },
        "operationId": "post-v1-projects-id-join"
      }
    },
    "/v1/projects/{id}/join-request": {
      "get": {
        "summary": "Get current user's join request for a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "User's join request details"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "No join request found"
          }
        },
        "operationId": "get-v1-projects-id-join-request"
      }
    },
    "/v1/projects/{id}/join-requests": {
      "get": {
        "summary": "Get all join requests for a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "approved",
                "declined"
              ],
              "default": "pending"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of join requests"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "get-v1-projects-id-join-requests"
      }
    },
    "/v1/projects/{id}/join-requests/{requestId}/approve": {
      "post": {
        "summary": "Approve a join request",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "requestId",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "role": {
                    "type": "string",
                    "enum": [
                      "Owner",
                      "Editor",
                      "Transcriber",
                      "ManualTranscriber",
                      "Reader"
                    ],
                    "default": "Reader"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Join request approved"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Join request not found"
          }
        },
        "operationId": "post-v1-projects-id-join-requests-requestid-approve"
      }
    },
    "/v1/projects/{id}/join-requests/{requestId}/decline": {
      "post": {
        "summary": "Decline a join request",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "requestId",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Join request declined"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Join request not found"
          }
        },
        "operationId": "post-v1-projects-id-join-requests-requestid-decline"
      }
    },
    "/v1/projects/pipeline/templates": {
      "get": {
        "summary": "Templates",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          }
        },
        "operationId": "get-v1-projects-pipeline-templates"
      }
    },
    "/v1/projects/{id}/pipeline": {
      "get": {
        "summary": "Get",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "get-v1-projects-id-pipeline"
      },
      "post": {
        "summary": "Create",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "post-v1-projects-id-pipeline"
      },
      "put": {
        "summary": "Update",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "put-v1-projects-id-pipeline"
      },
      "delete": {
        "summary": "Remove",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "delete-v1-projects-id-pipeline"
      }
    },
    "/v1/projects/{id}/units/{unitId}/steps/{stepKey}/state": {
      "patch": {
        "summary": "Patch decision",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "unitId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "stepKey",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "patch-v1-projects-id-units-unitid-steps-stepkey-state"
      }
    },
    "/v1/projects/{id}/units/{unitId}": {
      "patch": {
        "summary": "Patch unit",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "unitId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "patch-v1-projects-id-units-unitid"
      }
    },
    "/v1/projects/{id}/board": {
      "get": {
        "summary": "Board",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Pipelines"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "get-v1-projects-id-board"
      }
    },
    "/v1/projects/public": {
      "get": {
        "summary": "List all public projects (no authentication required)",
        "tags": [
          "Projects"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          },
          {
            "in": "query",
            "name": "search",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of public projects"
          }
        },
        "operationId": "get-v1-projects-public"
      }
    },
    "/v1/projects/organisation": {
      "get": {
        "summary": "List all organisation projects for the user's organisation",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          },
          {
            "in": "query",
            "name": "search",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of organisation projects visible to the user"
          },
          "400": {
            "description": "User does not belong to an organisation"
          }
        },
        "operationId": "get-v1-projects-organisation"
      }
    },
    "/v1/projects": {
      "post": {
        "summary": "Create a new project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 255
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "visibility": {
                    "type": "string",
                    "enum": [
                      "private",
                      "public",
                      "organisation"
                    ],
                    "default": "private",
                    "description": "Project visibility. Organisation visibility requires the owner to belong to an organisation."
                  },
                  "imageUrl": {
                    "type": "string",
                    "format": "uri",
                    "description": "URL to project image"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country related to the documents"
                  },
                  "city": {
                    "type": "string",
                    "description": "City related to the documents"
                  },
                  "fromYear": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9999,
                    "description": "Start year of time period"
                  },
                  "toYear": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9999,
                    "description": "End year of time period"
                  },
                  "languages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Languages used in documents"
                  },
                  "institution": {
                    "type": "string",
                    "description": "Institution or archive name"
                  },
                  "documentType": {
                    "type": "string",
                    "description": "Type of documents (e.g., letters, ledgers)"
                  },
                  "collectionIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Optional array of collection IDs to link to this project"
                  },
                  "siteIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Optional array of site IDs to link to this project"
                  },
                  "modelIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Optional array of model IDs to link to this project"
                  },
                  "settings": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Project created successfully"
          },
          "400": {
            "description": "Bad request"
          },
          "403": {
            "description": "Feature not available on current plan"
          }
        },
        "operationId": "post-v1-projects"
      },
      "get": {
        "summary": "List all accessible projects",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "type": "string",
              "enum": [
                "active",
                "archived",
                "deleted"
              ],
              "default": "active"
            }
          },
          {
            "in": "query",
            "name": "search",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of projects"
          }
        },
        "operationId": "get-v1-projects"
      }
    },
    "/v1/projects/plan-policies": {
      "get": {
        "summary": "Get the current user's plan policies and usage",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "Plan policies and usage data"
          }
        },
        "operationId": "get-v1-projects-plan-policies"
      }
    },
    "/v1/projects/{id}": {
      "get": {
        "summary": "Get a specific project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Project details with linked collections, sites, and models",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "data": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/Project"
                        },
                        {
                          "type": "object",
                          "properties": {
                            "collections": {
                              "type": "array",
                              "description": "Collections linked to this project with Transkribus data",
                              "items": {
                                "type": "object"
                              }
                            },
                            "sites": {
                              "type": "array",
                              "description": "Sites linked to this project",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "siteId": {
                                    "type": "integer"
                                  },
                                  "addedBy": {
                                    "type": "integer"
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time"
                                  }
                                }
                              }
                            },
                            "models": {
                              "type": "array",
                              "description": "Models linked to this project",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "modelId": {
                                    "type": "integer"
                                  },
                                  "addedBy": {
                                    "type": "integer"
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time"
                                  }
                                }
                              }
                            },
                            "userRole": {
                              "type": "string",
                              "description": "User's role in this project"
                            },
                            "assignableRoles": {
                              "type": "array",
                              "description": "Roles the calling user is allowed to assign when inviting members (empty if not permitted)",
                              "items": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Project not found"
          }
        },
        "operationId": "get-v1-projects-id"
      },
      "put": {
        "summary": "Update a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 255
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "settings": {
                    "type": "object"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "active",
                      "archived",
                      "deleted"
                    ]
                  },
                  "visibility": {
                    "type": "string",
                    "enum": [
                      "private",
                      "public",
                      "organisation"
                    ],
                    "description": "Project visibility. Changing to non-private requires Owner or Admin role. Organisation requires owner to belong to an organisation."
                  },
                  "imageUrl": {
                    "type": "string",
                    "format": "uri",
                    "description": "URL to project image"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country related to the documents"
                  },
                  "city": {
                    "type": "string",
                    "description": "City related to the documents"
                  },
                  "fromYear": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9999,
                    "description": "Start year of time period"
                  },
                  "toYear": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9999,
                    "description": "End year of time period"
                  },
                  "languages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Languages used in documents"
                  },
                  "institution": {
                    "type": "string",
                    "description": "Institution or archive name"
                  },
                  "documentType": {
                    "type": "string",
                    "description": "Type of documents (e.g., letters, ledgers)"
                  },
                  "collectionIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Optional array of collection IDs to sync (replaces existing)"
                  },
                  "siteIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Optional array of site IDs to sync (replaces existing)"
                  },
                  "modelIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Optional array of model IDs to sync (replaces existing)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Project updated successfully"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Project not found"
          }
        },
        "operationId": "put-v1-projects-id"
      },
      "delete": {
        "summary": "Delete a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "cascade",
            "schema": {
              "type": "string",
              "enum": [
                true,
                false
              ],
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Project deleted successfully"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Project not found"
          }
        },
        "operationId": "delete-v1-projects-id"
      }
    },
    "/v1/projects/{id}/stats": {
      "get": {
        "summary": "Get project stats",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "get-v1-projects-id-stats"
      }
    },
    "/v1/projects/{id}/visibility": {
      "post": {
        "summary": "Change project visibility",
        "description": "Dedicated endpoint for changing project visibility. Only project owners and admins can change visibility. Publishing (public/organisation) requires a Team or Organisation plan.",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "visibility"
                ],
                "properties": {
                  "visibility": {
                    "type": "string",
                    "enum": [
                      "private",
                      "public",
                      "organisation"
                    ]
                  },
                  "joinMode": {
                    "type": "string",
                    "enum": [
                      "auto_join",
                      "join_request"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Visibility updated successfully"
          },
          "400": {
            "description": "Invalid visibility value or missing organisation"
          },
          "403": {
            "description": "Access denied or plan restriction"
          }
        },
        "operationId": "post-v1-projects-id-visibility"
      }
    },
    "/v1/projects/{id}/members": {
      "get": {
        "summary": "Get project members",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of project members"
          }
        },
        "operationId": "get-v1-projects-id-members"
      }
    },
    "/v1/projects/{id}/members/{userId}/role": {
      "put": {
        "summary": "Update a user's role in a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "userId",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "role"
                ],
                "properties": {
                  "role": {
                    "type": "string",
                    "enum": [
                      "Owner",
                      "Editor",
                      "Transcriber",
                      "ManualTranscriber",
                      "Reader"
                    ],
                    "description": "New role for the user"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "User role updated successfully"
          },
          "400": {
            "description": "Invalid request or cannot change owner's role"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "User is not a member of this project"
          }
        },
        "operationId": "put-v1-projects-id-members-userid-role"
      }
    },
    "/v1/projects/{id}/members/{userId}": {
      "post": {
        "summary": "Add a new member to a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "userId",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Transkribus user ID to add to the project"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "role": {
                    "type": "string",
                    "enum": [
                      "Owner",
                      "Editor",
                      "Transcriber",
                      "ManualTranscriber",
                      "Reader"
                    ],
                    "default": "Reader",
                    "description": "Role to assign to the user"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "User added to project successfully"
          },
          "400": {
            "description": "Invalid request or user already a member"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "post-v1-projects-id-members-userid"
      },
      "delete": {
        "summary": "Remove a user from a project and all linked collections",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "userId",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Transkribus user ID to remove from the project"
          }
        ],
        "responses": {
          "200": {
            "description": "User removed from project"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "User is not a member of this project"
          }
        },
        "operationId": "delete-v1-projects-id-members-userid"
      }
    },
    "/v1/projects/{id}/leave": {
      "delete": {
        "summary": "Leave project",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "delete-v1-projects-id-leave"
      }
    },
    "/v1/projects/{id}/transfer-ownership": {
      "put": {
        "summary": "Transfer project ownership to another member",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ownership transferred successfully"
          },
          "400": {
            "description": "Invalid userId or user is already the owner"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "User is not a member of this project"
          }
        },
        "operationId": "put-v1-projects-id-transfer-ownership"
      }
    },
    "/v1/projects/collection-assignments": {
      "get": {
        "summary": "Check which collections are already assigned to projects",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "collectionIds",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated list of collection IDs to check"
          }
        ],
        "responses": {
          "200": {
            "description": "List of assignments. Members see projectId/projectName; non-members only see userHasAccess=false."
          },
          "400": {
            "description": "collectionIds query parameter is missing or invalid"
          }
        },
        "operationId": "get-v1-projects-collection-assignments"
      }
    },
    "/v1/projects/by-dataset/{datasetId}": {
      "get": {
        "summary": "Get all projects linked to a dataset",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "datasetId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of projects linked to the dataset"
          },
          "400": {
            "description": "Dataset ID is required"
          }
        },
        "operationId": "get-v1-projects-by-dataset-datasetid"
      }
    },
    "/v1/projects/{id}/collections": {
      "get": {
        "summary": "List collections in a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of collections with Transkribus data"
          }
        },
        "operationId": "get-v1-projects-id-collections"
      },
      "post": {
        "summary": "Add collections to a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "collectionIds"
                ],
                "properties": {
                  "collectionIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "minItems": 1,
                    "description": "Array of collection IDs from Transkribus API"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Collections added successfully"
          },
          "400": {
            "description": "Invalid collection IDs or no access"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "post-v1-projects-id-collections"
      }
    },
    "/v1/projects/{id}/collections/{collectionId}": {
      "delete": {
        "summary": "Remove a collection from a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "collectionId",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Collection removed successfully"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Collection not found in project"
          }
        },
        "operationId": "delete-v1-projects-id-collections-collectionid"
      }
    },
    "/v1/projects/{id}/sites": {
      "get": {
        "summary": "List sites in a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of sites in the project"
          }
        },
        "operationId": "get-v1-projects-id-sites"
      },
      "post": {
        "summary": "Add sites to a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "siteIds"
                ],
                "properties": {
                  "siteIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "minItems": 1,
                    "description": "Array of site IDs from external Site API"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Sites added successfully"
          },
          "400": {
            "description": "Invalid site IDs"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "post-v1-projects-id-sites"
      }
    },
    "/v1/projects/{id}/sites/{siteId}": {
      "delete": {
        "summary": "Remove a site from a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "siteId",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Site removed successfully"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Site not found in project"
          }
        },
        "operationId": "delete-v1-projects-id-sites-siteid"
      }
    },
    "/v1/projects/{id}/models": {
      "get": {
        "summary": "List models in a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of models in the project"
          }
        },
        "operationId": "get-v1-projects-id-models"
      },
      "post": {
        "summary": "Add models to a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "modelIds"
                ],
                "properties": {
                  "modelIds": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "minItems": 1,
                    "description": "Array of model IDs from external Model/HTR API"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Models added successfully"
          },
          "400": {
            "description": "Invalid model IDs"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "post-v1-projects-id-models"
      }
    },
    "/v1/projects/{id}/models/{modelId}": {
      "delete": {
        "summary": "Remove a model from a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "modelId",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Model removed successfully"
          },
          "403": {
            "description": "Access denied"
          },
          "404": {
            "description": "Model not found in project"
          }
        },
        "operationId": "delete-v1-projects-id-models-modelid"
      }
    },
    "/v1/projects/{id}/datasets": {
      "get": {
        "summary": "List datasets in a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of datasets in the project"
          }
        },
        "operationId": "get-v1-projects-id-datasets"
      },
      "post": {
        "summary": "Add datasets to a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "datasetIds"
                ],
                "properties": {
                  "datasetIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "minItems": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Datasets added successfully"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "post-v1-projects-id-datasets"
      }
    },
    "/v1/projects/{id}/datasets/{datasetId}": {
      "delete": {
        "summary": "Remove a dataset from a project",
        "tags": [
          "Projects"
        ],
        "security": [
          {
            "oAuth2AuthCode": [
              "openid"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "path",
            "name": "datasetId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Dataset removed successfully"
          },
          "403": {
            "description": "Access denied"
          }
        },
        "operationId": "delete-v1-projects-id-datasets-datasetid"
      }
    },
    "/v1/projects/{id}/tasks": {
      "get": {
        "summary": "List",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "get-v1-projects-id-tasks"
      },
      "post": {
        "summary": "Create",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "post-v1-projects-id-tasks"
      }
    },
    "/v1/projects/{id}/tasks/bulk": {
      "patch": {
        "summary": "Bulk patch",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "patch-v1-projects-id-tasks-bulk"
      }
    },
    "/v1/projects/{id}/tasks/{taskId}/progress": {
      "get": {
        "summary": "Progress",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "get-v1-projects-id-tasks-taskid-progress"
      }
    },
    "/v1/projects/{id}/tasks/{taskId}/status": {
      "patch": {
        "summary": "Patch status",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "patch-v1-projects-id-tasks-taskid-status"
      }
    },
    "/v1/projects/{id}/tasks/{taskId}": {
      "get": {
        "summary": "Detail",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "get-v1-projects-id-tasks-taskid"
      },
      "put": {
        "summary": "Update",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "put-v1-projects-id-tasks-taskid"
      },
      "delete": {
        "summary": "Remove",
        "description": "Documented from the route definition. Request and response schemas are not described yet; refine them when the operation is touched.",
        "tags": [
          "Tasks"
        ],
        "security": [
          {
            "oAuth2AuthCode": []
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Missing or invalid token"
          },
          "404": {
            "description": "Not found"
          }
        },
        "operationId": "delete-v1-projects-id-tasks-taskid"
      }
    }
  },
  "tags": []
}
