minimusdocs
Help center

Watch folders

Act on many files of a watch folder

POST/vod/watch-folders/{id}/files/bulk/

write Change: creates or edits. Scopes

action (as_is, retry or skip) on the files picked by ids, or on every file in a state.

Path parameters

  • idstring (uuid)required

    The watch folder's id.

Body

  • actionstringrequired
    • as_is - as_is
    • retry - retry
    • skip - skip

    One of: "as_is" "retry" "skip"

  • idsinteger[]
  • statestring
    • needs_you - needs_you
    • no_match - no_match
    • failed - failed
    • skipped - skipped
    • no_details - no_details

    One of: "needs_you" "no_match" "failed" "skipped" "no_details"

Response

200 OK

  • doneintegerrequired
  • refusedintegerrequired

    Files the action did not apply to.

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means