Sign in

v1

latestOpenAPI 3.0.0Forter License2026-07-1333204516.7 KB
demo
batch
agent-readiness

DEMO - submit a batch of decisioning operations

Demo-only batch surface published on www.forter.com for AI agent readiness, NOT on api.forter-secure.com. Accepts an array of operations (or an { operations: [...] } envelope) and returns 202 Accepted with Location: /batch/jobs/<job_id> + Retry-After: 1. Poll the URL until status=completed. Per-operation responses are canned (decision=NOT_REVIEWED) - production batch decisioning requires the real REST API with credentials issued at https://portal.forter.com after a signed MSA. The canonical (production) Forter REST surface remains single-event today; this batch endpoint exists strictly so AI scanners can verify the 202+polling pattern end-to-end against a reachable URL. See also: the BatchRequest / BatchResponse / BatchItemResult / BatchSize component schemas and the root x-batch extension below.

post/batch

Headers

Idempotency-Keystring

Optional. Folded into the returned job_id so a retry with the same key + body yields the same poll URL.

Request body

OR

Response

Batch accepted. Poll the URL in the Location header until status=completed.

object'batch_job' required
job_idstring required
status'pending' | 'completed' required
op_countinteger
poll_urlstring uri required
retry_after_secondsinteger required
created_atstring date-time
ops_acceptedobject[]
availabilityobject