Remove topic from Broker Schema

[joepavitt]

Description

Provide an option on a given topic in the hierarchy to "remove" it, as some users will test the broker first, before committing to a formal schema.

API should already be in place

Which customers would this be available to

Team + Enterprise Tiers (EE)

Have you provided an initial effort estimate for this issue?

I have provided an initial effort estimate

[hardillb]

• DELETE /api/v1/teams/:teamId/brokers/:brokerId/topics/:topicId

Should allow for the deleting of an individual topic and it's metadata

[joepavitt]

@Steve-Mcl any reason this is in-design, and not in-progress?

[Steve-Mcl]

@joepavitt my bad. I put it in design when looking at requirements then forgot to update status when i started work. (updated the status now that it is 80% complete 🤦)

[Steve-Mcl]

@joepavitt there were some pain points implementing this that would make reasonable follow ups

1. The organisation of the components (as in where the topic decoration occurs) made implementation difficult (the bare topic data is decorated in a sub component, but the topics are retrieved in the parent component meaning not so pretty workarounds had to be employed when handling updates/deletions)
2. The topic hierarchy API does NOT return the newly created object (or the update object) meaning we have to do a 2nd API call and re-request all topics (due to how we decorate the bare topics).
   3. In short, the API should return the newly created resource (or at minimum add a Location Header to permit a single request)