Last reviewed 2026-09-05Skill version 0.1.0Provisional
Prove that the batch job reached the end. The provider ran the batch and the results are ready. This level does not prove that every request inside the batch succeeded. Read openai.batch.all_requests_succeeded for that promise.
Run the requests of the input file as one batch job.
What is the subject and the action?
Member
Value
Subject type
openai.batch
Subject identity
batch_id = $action.result.id
Canonical effect
ai.batch_job_start
Provider operation
POST /batches
Idempotency
none, retry is not safe
How does the evidence correlate with this operation?
Strategy
Assurance
Keys
Required
resource_id
strong
batch_id from $action.result.id
yes
fingerprint
weak
input_file_id from $input.input_file_id; endpoint from $input.endpoint
no
Which evidence does the contract require?
Minimum evidence level E2. An independent channel is required. Minimum channels: 1.
Channel
Level
Independence
Verifier
Description
batch_readback
E2
provider readback
http
Read the batch from the provider. A condition path is $observed.batch_readback.status, and a second one is $observed.batch_readback.request_counts.failed.
batch_completed_events
E3
provider event
webhook
The batch.completed events of this batch. The payload carries the identifier of the batch and no other member of it, so the count states the end of the job and never the result of one request. The webhook verifier returns {events, count, latest, earliest, types, duplicates_dropped}.
Which conditions must all hold for VERIFIED?
Condition
Meaning
Path
Operator
Expected
Evidence
batch_present
The provider holds the batch with the returned identifier.
$observed.batch_readback.id
eq
$action.result.id
batch_readback
batch_status_completed
The batch reached the status completed. The published table states that the results are ready.
$observed.batch_readback.status
eq
completed
batch_readback
batch_input_file_matches
The batch reads the input file that the intent named.
$observed.batch_readback.input_file_id
eq
$input.input_file_id
batch_readback
batch_created_in_window
The provider created the batch after the operation started. OpenAI writes created_at in seconds since the epoch.
$observed.batch_readback.created_at
time_after
$operation.created_at
batch_readback
batch_completed_event
At least one batch.completed event names this batch. The payload carries the identifier only, so this condition states the end of the job and nothing about one request.
$observed.batch_completed_events.count
gte
1
batch_completed_events
Which conditions give CONTRADICTED?
Condition
Class
Reason
Path
Operator
Expected
batch_on_wrong_input_file
wrong subject
The batch reads a different input file than the intent named.
$observed.batch_readback.input_file_id
ne
$input.input_file_id
batch_on_wrong_endpoint
wrong subject
The batch calls a different endpoint than the intent named.
$observed.batch_readback.endpoint
ne
$input.endpoint
batch_predates_operation
pre existing state
The batch is older than the operation. It proves nothing.
$observed.batch_readback.created_at
time_before
$operation.created_at
Which observed states map to a verdict before completion?
Rule
Match
Verdict
Reason
terminal_failure
$observed.batch_readback.status in ["failed","expired"]
FAILED
The provider ended the batch without results. Read the errors of the input file.
cancelled
$observed.batch_readback.status eq "cancelled"
CONTRADICTED
A person or an agent cancelled the batch. Ask a person before a new batch runs.
still_running
$observed.batch_readback.status in ["validating","in_progress","finalizing","cancelling"]
PENDING
The batch has not reached a terminal status. The runtime observes again later.
How long does the runtime observe?
Timing member
Value
Initial delay
1000 ms
Poll interval
30000 ms
Backoff
exponential factor 2, max 900000 ms
Maximum attempts
120
Timeout
93600000 ms
Stale read window
60000 ms
On timeout
UNVERIFIABLE (evidence_unavailable_before_timeout), escalated to a person
Provely