Actions to support arrays returned

[nathan-t-lr]

Description

Often is the case where our team wants to return an array structure in a custom action. This is most often for custom search methods. As it is currently, we have to wrap the response in an object, which both messes up our dotviz diagrams and is not convenient. This issue was previously mention in this slack thread.

Expectation

The following was taken from the api-specs asset-lifecycle-api directory:

Current Feature:

sync bulk action v3/Asset::get {
    "Identifier objects used to request an `Asset`"
    assetIDs: value-of AssetV3BulkGetRequest[]
    "The amount of detail to return for the `Asset`."
    includes: value-of AssetV3IncludesEnum[1..3] optional
    /operations
        POST
            "OK" 200
                MultigetResponseV3 // this is a `structure` that wraps our `AssetV3BulkGetResponse[]` structure
}

Desired Feature:

sync bulk action v3/Asset::get {
    "Identifier objects used to request an `Asset`"
    assetIDs: value-of AssetV3BulkGetRequest[]
    "The amount of detail to return for the `Asset`."
    includes: value-of AssetV3IncludesEnum[1..3] optional
    /operations
        MULTIPOST
            "OK" 200
                AssetV3BulkGetResponse
}

Solution:

My guess is to allow an action to accept MULTI-verbs as I have shown in the desired feature.