Update an insurance import

patch

https://api.wingspan.app/v3/compliance/insurance-imports/{importId}

Replace the VaultFile on a pending or rejected InsuranceImport before it is submitted. Corrected extracted policy data is reserved for a later backing-service release and returns 422 until then.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

importId

string

required

Unique identifier of the insurance import

Body Params

Replace the uploaded Certificate of Insurance and re-run extraction. This consumes one import attempt, bounded by maxAttempts.

Extracted data is deliberately not writable. It is the extraction job's own output — there is no upstream write path for it, so a caller-supplied correction would have nowhere to land.

fileId

string

required

Replacement VaultFile containing the Certificate of Insurance. The file must be private and owned by the request account context.

Headers

Idempotency-Key

string

length between 1 and 255

^[\x21-\x7e]{1,255}$

Optional idempotency token for authenticated POST and PATCH requests. Reusing the same key and body returns the cached response for 24 hours, except credential operations that explicitly document a 409 because one-time secret material is never cached; reusing it with a different body returns 409 IdempotencyKeyConflict. Use 1-255 printable ASCII characters.

X-Wingspan-Account

string

^(?:[A-Za-z0-9_.]{22}|[a-f0-9]{24})$

Select the Account for an Account-scoped operation. A direct ServiceAccount API key MUST supply this header, and the target must be within the ServiceAccount owner's or Authorization grant's Account boundary. A Person bearer may select an Account on which it has an active Stakeholder, and an Account session may select its bound Account (or a descendant only when the session explicitly includes descendants).

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Updated insurance import

400Malformed request syntax

401Unauthenticated

403Forbidden

404Resource not found

422Validation error. detailCode: compliance.InsuranceImportAttemptLimitExceeded when the import has already consumed maxAttempts.