routes appear under tag of Apirouter and parent Apirouter

First check

• I added a very descriptive title to this issue.
• I used the GitHub search to find a similar issue and didn’t find it.
• I searched the FastAPI documentation, with the integrated search.
• I already searched in Google “How to X in FastAPI” and didn’t find any information.
• I already read and followed all the tutorial in the docs and didn’t find an answer.
• I already checked if it is not related to FastAPI but to Pydantic.
• I already checked if it is not related to FastAPI but to Swagger UI.
• I already checked if it is not related to FastAPI but to ReDoc.
• After submitting this, I commit to one of:
  • Read open issues with questions until I find 2 issues where I can help someone and add a comment to help there.
  • I already hit the “watch” button in this repository to receive notifications and I commit to help at least 2 people that ask questions in the future.
  • Implement a Pull Request for a confirmed bug.

Example

Here’s a self-contained, minimal, reproducible, example with my use case:

import uvicorn
from fastapi import FastAPI, APIRouter

items = {}
app = FastAPI()

router = APIRouter(prefix="/api")
items_router = APIRouter(prefix="/items", tags=["items"])

@items_router.post("/{id}")
def add_item(id: str):
	items[id] = {"attachments": []}
	return items[id]

@items_router.get("/{id}")
def get_item(id: str):
	if not (item := items.get(id)):
		return "error"
	return item

items_attachment_router = APIRouter(prefix="/{id}", tags=["attachment"])

@items_attachment_router.post("/add")
def add_attachment(id: str, attachment: str):
	if not (item := items.get(id)):
		return "error"
	item["attachments"].append(attachment)
	return item

items_attachment_router2 = APIRouter()

@items_attachment_router2.post("/{id}/add2")
def add_attachment2(id: str, attachment: str):
	if not (item := items.get(id)):
		return "error"
	item["attachments"].append(attachment)
	return item

items_router.include_router(items_attachment_router)
items_router.include_router(items_attachment_router2, tags=["attachment2"])
router.include_router(items_router)
app.include_router(router)

if __name__ == "__main__":
	uvicorn.run(app)

Description

the routes of an APIRouter appear under the tags given by the router and all parent routers. I implemented it the old and the new way (adding tags to the router directly & adding them as a param in include_router). Both methods put the routes add_attachment and add_attachment2 under their own tag and them items tag

• Python version: 3.8

Additional context

FastAPI version 0.62.0

[ajju10]

Please describe the issue clearly or better to share a screenshot of the page you are getting issue with along with the clean description of your issue.

[transfluxus]

Hi,

sorry, the issue is that the routes appear twice (in swagger)

https://imagebin.ca/v/5kgpOV3O3InG