Create an interview batch
Queue several interviews in one durable request and track outcomes by your own itemKey. Use this to process an application import without coordinating every admission yourself.
Before you call
Supply 1–20 items, at most 256 KiB JSON, unique itemKey values, and an Idempotency-Key. Only one batch of each kind can be active per workspace.
Required scope: interviews:write.
What happens next
A 202 returns batchId and statusUrl. Items can succeed or fail independently. Items finish when invitation admission succeeds or fails, not when candidates finish interviewing. Only sendEmail=true is supported in invitation batches.
Recovery
Keep successful resource IDs. Capacity-limited items can wait up to the admission deadline; inspect per-item errorCode. Retry failed items deliberately in a new batch; analysis/interview items need fresh quotes. Foreign or unknown resource IDs reject the envelope.
Follow the complete workflow · Errors and retries
Request
- Base URL: https://app.probbai.com
- URL: https://app.probbai.com/api/v1/interview-batches
- Auth: HTTP bearer
Headers
Stable key for one logical write. Retry the identical body with the same key after a timeout; a changed body conflicts. 1–128 letters, digits, dots, underscores, colons, or hyphens.
Request body
Response
A 202 returns batchId and statusUrl. Items can succeed or fail independently. Items finish when invitation admission succeeds or fails, not when candidates finish interviewing. Only sendEmail=true is supported in invitation batches.
Changes
No recorded changes to this operation across all 1 revision of this API.