Delete Policy Transaction

curl --request DELETE \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/policies/{policyId}/transactions/{transactionId} \
  --header 'Authorization: <api-key>'

{
  "id": "550e8400-e29b-41d4-a716-446655440020",
  "deleted": true
}

Transactions

Delete Policy Transaction

Deletes the most recent transaction on a policy, rolling the policy back to its prior version. Only the most recent transaction (highest policyVersion) can be deleted — attempting to delete an older transaction returns a 400 error.

After deletion, the policy state reverts to what it was before the deleted transaction was applied. If the only transaction (NEW_BUSINESS) is deleted, the policy has no remaining transactions.

Required permission: policy:delete

DELETE

api

external

companies

{companyId}

policies

{policyId}

transactions

{transactionId}

Delete Policy Transaction

curl --request DELETE \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/policies/{policyId}/transactions/{transactionId} \
  --header 'Authorization: <api-key>'

{
  "id": "550e8400-e29b-41d4-a716-446655440020",
  "deleted": true
}

Authorizations

Authorization

string

header

required

API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.

Path Parameters

companyId

string<uuid>

required

Company identifier

policyId

string<uuid>

required

Policy identifier

transactionId

string<uuid>

required

Transaction identifier

Response

Transaction deleted successfully

string<uuid>

required

The ID of the deleted transaction

deleted

boolean

required

Confirmation that the transaction was deleted

Renew Policy Transaction Get Policy Version

⌘I