Fail a leased capture-agent job safely
POST/api/v1/capture-agent/jobs/:job_id/failure
Requires the narrow device credential and current lease token. Records one server-defined scan_failed, assembly_failed, or local_storage_failed reason, clears the lease, and returns the terminal job without accepting agent-supplied error text.
Request
Responses
- 200
- 400
- 401
- 404
- 409
- 421
- 503
Terminal failure recorded and lease cleared
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request syntax, headers, body, or validated input is malformed or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The resource is unknown or outside the authenticated household scope
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request conflicts with the current resource, revision, lease, credential, or idempotency state
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request authority or direct peer is outside the configured Jiandu ingress boundary
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
A required core dependency is unavailable; retry with bounded backoff
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.