-
Notifications
You must be signed in to change notification settings - Fork 104
Open
Labels
status: help wantedrequesting help from the communityrequesting help from the communitytype: community enhancementfeature request not on Twilio's roadmapfeature request not on Twilio's roadmap
Description
Issue Summary
Please add tags to the specs to make them easier to navigate when using tools like Swagger UI.
For example, this is the current untagged Verify spec when rendered in Swagger UI:
https://johnchaffee.wiki/twilio-swagger/apis/verify-untagged/
And this is the same spec with tags added:
https://johnchaffee.wiki/twilio-swagger/apis/verify/
As you can see, the tagged version is easier for a human to navigate.
Steps to Reproduce
For each method (get, post, put, delete) add a tags item that describes the resource it is associated with.
For example, add "tags": ["Verifications"] to the post method in the /v2/Services/{ServiceSid}/Verifications path:
"post": {
"tags": ["Verifications"],
"description": "Create a new Verification using a Service",Technical details:
- twilio-oai version: 1.3.4
Other
Let me know if I can help in any way.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
status: help wantedrequesting help from the communityrequesting help from the communitytype: community enhancementfeature request not on Twilio's roadmapfeature request not on Twilio's roadmap