apiblueprint - Custom action names in API Blueprint -


I am trying to write an API and struggling to find a good way to add custom actions to a resource I am For example, in my user processing, I have to disable enable and disable , but in the normal Blueprint group, I can not add them under one group:

  ## User [/ User / {ID}] ### Update a user [Patch] ... ### Delete a user [Delete] ... ### Disable one user Do [patch] ....  

here, disable a user and one use Update indicates both URL that is not what I want. I want the URL / users / {id} and / users / {id} / disabled respectively URL.

Other API sources, others have done it without using the named resources, which will give:

  ## / users / {id} ### A user Update [Patch] ... ### Delete a user [Delete] ... ## / Users / {ID} / Disable ### Disable a User [Patch] ...  

As long as I can use this approach, I like to use the first approach because it is cleaner when it is the most blue Rinting tool is provided.

Is there a way to use custom actions in the first way, or someone else has a cleaner way of implementing the same type of thing in this example, because there are two different URLs, you actually Will end with two separate parts

  # group user resources ## user [/ user / {id}] ### update a user [patch] ... ### Delete a user [Delete] .. ## Disable User [/ User / {ID} / Disable] ### Disable User [Patch] ...  

This allows you to separate individual URLs You can work, while keeping them together in your document.


Comments