Skip to main content
POST
Apply a bulk action

Authorizations

Authorization
string
header
required

Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)

Body

application/json
action
enum<string>
required
Available options:
transition
state
enum<string>
required
Available options:
active,
archived,
trashed
filter
object
dry_run
boolean
max_items
integer
Required range: x > 0
emit_events
boolean

Response

Dry-run result (synchronous; non-dry-run goes async)

action
string
required
matched
integer
required
succeeded
integer
required
errored
integer
required
dry_run
boolean
required
ids
string[]
errors
object[]
blob_hashes_referenced
integer