Skip to main content
POST
Run a bulk batch

Authorizations

session
string
cookie
required

A signed-in workspace session, sent as a browser cookie. Requests must include credentials, and act on the session's active workspace.

Body

application/json
items
object[]
required

Job descriptions. Entries shorter than 12 characters are dropped before the cap is applied.

Required array length: 1 - 10 elements
mode
enum<string>
default:candidate

candidate searches for people against a role. client discovers target companies first, then their decision-makers.

Available options:
candidate,
client
model
enum<string>

Which model extracts criteria. Anything outside this allowlist is rejected. Omit to use the workspace default.

Available options:
claude-haiku-4-5,
claude-sonnet-5,
claude-opus-5

Response

The batch was queued.

batchId
string<uuid>
queued
integer

How many job descriptions were accepted.