Skip to main content
PUT
/
api
/
v1
/
external
/
companies
/
{companyId}
/
submissions
/
{submissionId}
Update Submission
curl --request PUT \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions/{submissionId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionName": "Acme Corp Renewal"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440010",
  "companyId": "550e8400-e29b-41d4-a716-446655440000",
  "fieldModelV1Data": {
    "submissionNumber": "SUB-2025-001",
    "submissionName": "Acme Corp Renewal",
    "submissionType": "newBusiness",
    "submissionStatus": "quoteInProgress",
    "submissionPrimaryInsured": "Acme Corp",
    "submissionQuotes": [
      "550e8400-e29b-41d4-a716-446655440001"
    ]
  },
  "createdAt": "2025-01-15T10:30:00.000Z",
  "createdBy": "google-oauth2|123456789",
  "updatedAt": "2025-01-20T14:00:00.000Z",
  "updatedBy": null
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header.

Path Parameters

​
companyId
string<uuid>
required

Company identifier

​
submissionId
string<uuid>
required

Submission identifier

Body

application/json

Submission field data to update (keys are field referenceIds)

Response

Submission updated successfully

A Field Model V1 submission with custom field data.

​
id
string<uuid>
required

Submission identifier

​
companyId
string<uuid>
required

Company identifier

​
fieldModelV1Data
object
required

Submission-level custom field data. Keys are field referenceIds defined in the company's field configuration. Includes lifecycle fields (submissionStatus, submissionType, submissionNumber, submissionName, submissionPrimaryInsured, submissionBoundDate, submissionQuotes) which are read-only and system-managed.

​
createdAt
string<date-time>
required

When the submission was created

​
createdBy
string | null

User ID who created the submission

​
updatedAt
string<date-time> | null

When the submission was last updated

​
updatedBy
string | null

User ID who last updated the submission