Add Endpoint to retry failed document actions

[mfriesen]

With GET /documents?actionStatus=FAILED now returning failed document actions status. It would be nice to add an ability to retry this failed action.

Maybe an point like
PATCH /documents/{documentId}/actions/{FAILED} would be nice.

possible
PATCH /documents/actions/{FAILED} to loop through all failed actions and retry them all. Would be nice if there was a mass failure for some reason.

[reganwolfrom]

@mfriesen While a PATCH for all could work, I feel like in most cases, the goal will be to retry some documents' actions, not all. Plus, if a document action fails, isn't that FAILED action still listed, even after the document action is retried? For audit purposes we would not want to remove that failure, but submit a new set of one or more actions for retry. So the PATCH would then continually retry for any action that ever failed, even if retried.

To be honest, I think the best way to handle this for now, while we do not have IDs for individual action requests, is to not include a retry endpoint, but to allow the user to script retries based on the results of the actionStatus=FAILED GET.

If we eventually add IDs to individual action requests, we could then have a POST /documents/{documentId}/actions/{actionId}/retry

(I'm thinking "retry" vs. "retries", simply because you should not have more than one "retry" at a time for an action.)