curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/imports/retry \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"importRowId": "9c5e1a3d-7f2b-4d8e-a6c4-1b9f3e7d2a58",
"transformations": {
"locations": {
"mapOver": "submission.sites",
"values": {
"state": "region"
}
}
},
"attemptBatch": "october-fix"
}
'{
"importRowId": "9c5e1a3d-7f2b-4d8e-a6c4-1b9f3e7d2a58",
"importAttempt": {
"id": "4a8d2f6c-3e1b-4b7a-9c05-6e2d8f1a3b97",
"importRowId": "9c5e1a3d-7f2b-4d8e-a6c4-1b9f3e7d2a58",
"entityType": "Submission",
"action": "create",
"attemptBatch": "october-fix",
"transformations": {
"locations": {
"mapOver": "submission.sites",
"values": {
"state": "region"
}
}
},
"guards": [],
"transformationResult": {
"status": "ok",
"entity": {
"name": "Acme Logistics",
"sites": [
{
"region": "CA"
}
],
"locations": [
{
"state": "CA"
}
]
}
},
"guardResult": {
"passed": true
},
"writeResult": {
"status": "ok",
"entityId": "1f8d3b7a-6e2c-4a9d-8b51-4c7e2a9f3d06",
"created": true
},
"createdAt": "2026-10-23T16:12:40.318Z",
"updatedAt": "2026-10-23T16:12:40.702Z"
}
}Retry Import
Fixes a failed import by running a stored row again with corrected
transformations or guards, without sending the data again. It applies to
rows stored by Import Entity (createFmv1Import); rows stored by Import
Rows (ingestFmv1ImportRows), and attempts made by an import job, are run
again by queueing another job with Queue Import Job (queueFmv1ImportJob).
Find the failed row or attempt with List Import Attempts
(listFmv1ImportAttempts).
Retries a stored import row: fixes a failed import with new transformations
or guards, without sending the data again. Name the row by importRowId, to
retry it with the transformations and guards you send, or by
importAttemptId, to retry that attempt’s row with the attempt’s own.
The retry reads the row’s data and entity type, then runs the steps of
Import Entity after the row is stored: the transformations turn
data.<entityKey> into an entity, the guards run against it, and the
entity is created, or updated when the transformed entity carries an
id. A row that already created its entity creates another unless the
transformations set id, such as with LOOKUP. A row cannot be retried as
another entity type.
Every retry of a row you can import answers 201 with the new import
attempt, linked to the same row, whether or not the entity was written:
check importAttempt.writeResult. Its attemptBatch is the request’s. No
row is stored.
A malformed request is a 400, and records nothing: both ids or neither,
transformations or guards sent with an importAttemptId, an id that is
not a UUID, a blank attemptBatch, a body key this endpoint does not take,
or any query parameter.
There is no Idempotency-Key: sending the same retry twice records two
attempts, and may write twice.
Required permission: <entityType>.import for the stored row’s entity
type, such as submission.import to retry a Submission row. The row’s type
is known only once it is read, so a caller holding no import permission is
a 403, and a row or attempt of a type you cannot import is a 404, the
same as an id that exists nowhere.
curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/imports/retry \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"importRowId": "9c5e1a3d-7f2b-4d8e-a6c4-1b9f3e7d2a58",
"transformations": {
"locations": {
"mapOver": "submission.sites",
"values": {
"state": "region"
}
}
},
"attemptBatch": "october-fix"
}
'{
"importRowId": "9c5e1a3d-7f2b-4d8e-a6c4-1b9f3e7d2a58",
"importAttempt": {
"id": "4a8d2f6c-3e1b-4b7a-9c05-6e2d8f1a3b97",
"importRowId": "9c5e1a3d-7f2b-4d8e-a6c4-1b9f3e7d2a58",
"entityType": "Submission",
"action": "create",
"attemptBatch": "october-fix",
"transformations": {
"locations": {
"mapOver": "submission.sites",
"values": {
"state": "region"
}
}
},
"guards": [],
"transformationResult": {
"status": "ok",
"entity": {
"name": "Acme Logistics",
"sites": [
{
"region": "CA"
}
],
"locations": [
{
"state": "CA"
}
]
}
},
"guardResult": {
"passed": true
},
"writeResult": {
"status": "ok",
"entityId": "1f8d3b7a-6e2c-4a9d-8b51-4c7e2a9f3d06",
"created": true
},
"createdAt": "2026-10-23T16:12:40.318Z",
"updatedAt": "2026-10-23T16:12:40.702Z"
}
}Authorizations
User-principal OAuth 2.0 Bearer authentication. Send a user-scoped Auth0 access token (audience = the app API audience) as Authorization: Bearer <jwt>. The request resolves to the user's identity and is authorized by their Role on the {companyId} in the path — the same role-based permissions the web app enforces. This is the path the MCP connector uses to act on a user's behalf; endpoints that accept it list both BearerAuth and ApiKeyAuth.
Body
A new attempt on a stored import row. Name the row by exactly one of
importRowId or importAttemptId:
importRowIdretries the row with thetransformationsandguardsyou send (none of each when omitted, as on Import Entity).importAttemptIdretries that attempt's row with the attempt's owntransformationsandguards. Sending either alongside it is a400; retry byimportRowIdto change them.
The data is the row's, as it was first sent, and so is the entity type: a row cannot be retried as another entity type.
Response
A new attempt was recorded on the row. Whether the entity was written is
the attempt's writeResult.
The stored import row's id and the attempt this request recorded.
One import attempt: a single transform → guard → write pass over an
import row. An import request records the first attempt on its row, and each
retryImport records another. Attempts are stored whether or not the write
happened.
The attempt is recorded before its first step runs, with every result null,
and each step's result is stored on it as the step completes:
transformationResult and action, then guardResult, then writeResult.
The import and retryImport responses answer with the finished attempt.
writeResult is stored in the same transaction as the entity write, so the
two commit together or not at all. An attempt whose guardResult passed and
whose writeResult is null wrote no entity: it is still in progress, or it
crashed before its write committed. Its import row can be retried; the retry
cannot create a second entity alongside one the crashed attempt wrote.
Show child attributes
Show child attributes