Skip to content

Add tags to specs #74

@johnchaffee

Description

@johnchaffee

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.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions