Cancel an in-flight backfill run

POST

/admin/metadata-extraction/backfills/{id}/cancel

• Local development behind nginx (port 8088 by default)

Flips cancelled_at to NOW(). The running coordinator job observes the flag on the next batch boundary + exits cleanly. Already-cancelled / already-completed runs are no-ops (returns 204). 404 if the id never existed.

Gated on system.admin.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

204

Cancellation accepted.

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed