POST
/v1/api/jobs/{id}/startStart a job
Scope processing. Upload every file first. Starting the same files again answers the job already running.
Send request
Use the documented inputs to call this endpoint directly.
API serverbase URL
Bearer tokenkeyoptional
Stored only in this browser for the key security scheme and reused on every API page in this group.
Parameters
Values are applied to the request and the example on the right.
idpath · stringrequired
The job's id, from the declare.
Request body
application/jsonproductTypestringoptional
The deal type: mca, term_loan, line_of_credit, sba, or your own.
idempotencyKeystringoptional
replacebooleanoptional
Consent to replace fields a person entered.
Responses
200application/json
Already started with these files.
{
"data": {
"id": "",
"state": "awaiting_start",
"created": true,
"job": {
"id": "",
"status": "started",
"externalJobId": "",
"idempotencyKey": "string",
"requestedBy": "string",
"requestedAt": "2026-01-01T00:00:00Z",
"finishedAt": "2026-01-01T00:00:00Z",
"finished": true,
"events": [
{
"seq": 1,
"event": "string",
"at": "2026-01-01T00:00:00Z",
"detail": {}
}
],
"documents": [
{
"id": "",
"fileId": "",
"fileName": "string",
"documentType": "string",
"attemptNo": 1,
"outcome": "pending",
"reason": "string",
"contentSha256": "string",
"at": "2026-01-01T00:00:00Z",
"extractions": [
{
"jobId": "",
"kind": "string",
"source": "string",
"engine": "string",
"modelVersion": "string",
"confidenceBps": 1,
"fields": [
{
"field": "string",
"value": "string",
"confidenceBps": 1,
"page": 1
}
],
"notes": [
"string"
]
}
]
}
],
"findings": "string"
}
}
}dataoptional
201application/json
Started.
{
"data": {
"id": "",
"state": "awaiting_start",
"created": true,
"job": {
"id": "",
"status": "started",
"externalJobId": "",
"idempotencyKey": "string",
"requestedBy": "string",
"requestedAt": "2026-01-01T00:00:00Z",
"finishedAt": "2026-01-01T00:00:00Z",
"finished": true,
"events": [
{
"seq": 1,
"event": "string",
"at": "2026-01-01T00:00:00Z",
"detail": {}
}
],
"documents": [
{
"id": "",
"fileId": "",
"fileName": "string",
"documentType": "string",
"attemptNo": 1,
"outcome": "pending",
"reason": "string",
"contentSha256": "string",
"at": "2026-01-01T00:00:00Z",
"extractions": [
{
"jobId": "",
"kind": "string",
"source": "string",
"engine": "string",
"modelVersion": "string",
"confidenceBps": 1,
"fields": [
{
"field": "string",
"value": "string",
"confidenceBps": 1,
"page": 1
}
],
"notes": [
"string"
]
}
]
}
],
"findings": "string"
}
}
}dataoptional
400application/json
The job has no documents to process.
{
"error": {
"message": "string"
}
}errorrequired
401application/json
No key, or an unknown or revoked one.
{
"error": {
"message": "string"
}
}errorrequired
402application/json
A key issued from Settings → Developer, on a workspace without the Enterprise plan.
{
"error": {
"message": "string"
}
}errorrequired
403application/json
The key was not given processing, or is a board key.
{
"error": {
"message": "string"
}
}errorrequired
404application/json
No job or deal with that id that this key can reach.
{
"error": {
"message": "string"
}
}errorrequired
409application/json
would_supersede: send replace: true to go ahead.
{
"error": {
"message": "string",
"code": "would_supersede"
},
"superseded": [
"string"
]
}erroroptional
supersededarray<string>optional
The fields a re-run would replace.