Skip to main content
PATCH
cURL
Updates the fields you own on an association: your two identifiers, externalId and producerCode, and your record of the agency’s profile, entityType, legalAddress, mailingAddress, doingBusinessAs, website, phoneNumber and faxNumber. Send a value to set a field, null to clear it, and leave a key out to keep its stored value. At least one key must be present. An empty string is rejected. These are your organization’s copy of the agency’s details. Changing them does not change the agency’s own record in Turris or what other carriers hold. A change to any of the profile fields sends the Agency Updated webhook. Addresses replace, they do not merge. legalAddress and mailingAddress take a complete US address: line1, city, state and zip are required, line2 is optional, and country is stored as USA. A part you leave out is not kept from the stored address. Phone and fax numbers must be US numbers with 10 digits. Common formats are accepted (2155550100, 215-555-0100, (215) 555-0100, +1 215 555 0100) and stored as +1 (215) 555-0100, which is what the response returns. Only the identifiers are unique. Sending an externalId or producerCode another of your associations already carries returns 409 with errorType duplicate_external_id_error or duplicate_producer_code_error. Sending an association’s own current value back is not a conflict. The response is the full association, identical in shape to Get Association.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string

UUID to ensure idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

x-idempotency-key
string

Alternative UUID header for idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

downstreamEntityAssociationId
string
required

Downstream entity association ID

Example:

"507f1f77bcf86cd799439011"

Body

application/json
externalId
string | null

Your own identifier for this association, for example the record key in your producer management system. Pass a non-empty string to set it, or null to clear it. An empty string is rejected. Must be unique across your associations. Leave the key out to keep the stored value.

Minimum string length: 1
Example:

"EXT-12345"

producerCode
string | null

Producer code you assign to this downstream entity location. Pass a non-empty string to set it, or null to clear it. An empty string is rejected. Must be unique across your associations. Leave the key out to keep the stored value.

Minimum string length: 1
Example:

"PROD-001"

entityType
enum<string> | null

The agency's legal structure. Pass one of the listed values to set it, or null to clear it. Leave the key out to keep the stored value.

Available options:
C-Corp,
LLC,
Partnership,
S-Corp,
Sole Proprietor
Example:

"LLC"

The agency's legal address. Replaces the stored address whole: a part you leave out is not kept from the stored address. Pass null to clear it. Leave the key out to keep the stored value.

mailingAddress
object | null

The agency's mailing address. Replaces the stored address whole: a part you leave out is not kept from the stored address. Pass null to clear it. Leave the key out to keep the stored value.

doingBusinessAs
string | null

The agency's doing-business-as name. Pass a non-empty string to set it, or null to clear it. An empty string is rejected. Leave the key out to keep the stored value.

Minimum string length: 1
Example:

"Example Insurance Agency"

website
string | null

The agency's website, an http or https URL. The scheme may be left out. Pass null to clear it. Leave the key out to keep the stored value.

Example:

"https://www.example-agency.com"

phoneNumber
string | null

The agency's phone number: a US number with 10 digits. Common formats such as 2155550100, 215-555-0100, (215) 555-0100 or +1 215 555 0100 are accepted and stored as +1 (215) 555-0100. Pass null to clear it. Leave the key out to keep the stored value.

Example:

"+1 (215) 555-0100"

faxNumber
string | null

The agency's fax number: a US number with 10 digits, accepted and stored the same way as phoneNumber. Pass null to clear it. Leave the key out to keep the stored value.

Example:

"+1 (215) 555-0101"

Response

Updated downstream entity association

data
object
required
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"