Create Re-upload Intent

curl --request POST \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileName": "loss-run-revised.pdf",
  "contentType": "application/pdf",
  "byteSize": 118220
}
'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions"

payload = {
    "fileName": "loss-run-revised.pdf",
    "contentType": "application/pdf",
    "byteSize": 118220
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fileName: 'loss-run-revised.pdf',
    contentType: 'application/pdf',
    byteSize: 118220
  })
};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fileName' => 'loss-run-revised.pdf',
    'contentType' => 'application/pdf',
    'byteSize' => 118220
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions"

	payload := strings.NewReader("{\n  \"fileName\": \"loss-run-revised.pdf\",\n  \"contentType\": \"application/pdf\",\n  \"byteSize\": 118220\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fileName\": \"loss-run-revised.pdf\",\n  \"contentType\": \"application/pdf\",\n  \"byteSize\": 118220\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fileName\": \"loss-run-revised.pdf\",\n  \"contentType\": \"application/pdf\",\n  \"byteSize\": 118220\n}"

response = http.request(request)
puts response.read_body

{
  "fileId": "550e8400-e29b-41d4-a716-446655440020",
  "versionId": "550e8400-e29b-41d4-a716-446655440022",
  "uploadUrl": "https://storage.googleapis.com/bucket/companies/.../files/...?X-Goog-Expires=900&X-Goog-Signature=..."
}

Versions

Create Re-upload Intent

Phase 1 of a re-upload: mint a NEW version of an existing file. Identical to a first-version upload intent from the client’s perspective — declare the new bytes (name, MIME type, exact byte size) and receive a short-lived signed uploadUrl pinned to the declared content type and byte size.

To complete the re-upload:

PUT the raw bytes to uploadUrl with the two signed headers (Content-Type: <the contentType you declared> and x-goog-content-length-range: <byteSize>,<byteSize>). Bytes go straight to cloud storage — never through this API.
POST /files/{fileId}/finalize with the returned versionId — the SAME finalize endpoint first uploads use. Finalize flips the new version ready and repoints the file at it, so the new bytes silently become current. The file keeps its id, placements, categories, and full history.

Because a re-upload changes an existing file, it is gated by company.file:update — not company.file:create.

Required permission: company.file:update

POST

api

companies

{companyId}

files

{fileId}

versions

Create Re-upload Intent

curl --request POST \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileName": "loss-run-revised.pdf",
  "contentType": "application/pdf",
  "byteSize": 118220
}
'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions"

payload = {
    "fileName": "loss-run-revised.pdf",
    "contentType": "application/pdf",
    "byteSize": 118220
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fileName: 'loss-run-revised.pdf',
    contentType: 'application/pdf',
    byteSize: 118220
  })
};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fileName' => 'loss-run-revised.pdf',
    'contentType' => 'application/pdf',
    'byteSize' => 118220
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions"

	payload := strings.NewReader("{\n  \"fileName\": \"loss-run-revised.pdf\",\n  \"contentType\": \"application/pdf\",\n  \"byteSize\": 118220\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fileName\": \"loss-run-revised.pdf\",\n  \"contentType\": \"application/pdf\",\n  \"byteSize\": 118220\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/files/{fileId}/versions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fileName\": \"loss-run-revised.pdf\",\n  \"contentType\": \"application/pdf\",\n  \"byteSize\": 118220\n}"

response = http.request(request)
puts response.read_body

{
  "fileId": "550e8400-e29b-41d4-a716-446655440020",
  "versionId": "550e8400-e29b-41d4-a716-446655440022",
  "uploadUrl": "https://storage.googleapis.com/bucket/companies/.../files/...?X-Goog-Expires=900&X-Goog-Signature=..."
}

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

fileId

string<uuid>

required

File identifier

Body

application/json

fileName

string

required

File name for the new version (must be non-empty)

contentType

string

required

MIME type of the new version (e.g. application/pdf); must be an allowed type

byteSize

integer

required

Exact size of the new version in bytes (max 1073741824 = 1 GiB)

Response

Re-upload intent created — PUT the bytes to uploadUrl, then finalize

fileId

string<uuid>

Id of the file (unchanged)

versionId

string<uuid>

Id of the new pending version — pass it to finalize

uploadUrl

string

Short-lived signed URL to PUT the new version's bytes to (expires in 15 minutes)

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

Create Re-upload Intent

Authorizations

Path Parameters

Body

Response