{
"success": false,
"errorCode": "policy-update-not-supported",
"message": "Policy update \"update-third-party\" is not supported for this policy."
}
{
"success": false,
"errorCode": "policy-update-in-progress",
"message": "A policy update is already in progress for this policy. Please try again later."
}
{
"success": false,
"errorCode": "default",
"message": "Oops something went wrong. Please try again later."
}
Policies
Request Policy Update
Request a change to a policy on behalf of your user. Once submitted, Axle will process the request.
For more details on supported operations and error codes, see the Policy Updates guide.
{
"success": false,
"errorCode": "policy-update-not-supported",
"message": "Policy update \"update-third-party\" is not supported for this policy."
}
{
"success": false,
"errorCode": "policy-update-in-progress",
"message": "A policy update is already in progress for this policy. Please try again later."
}
{
"success": false,
"errorCode": "default",
"message": "Oops something went wrong. Please try again later."
}
Authorizations
x-client-secret
string
header
required
Your secret API key. This will be shared with you during onboarding and should be considered sensitive - it’s a password after all! Your secret will be matched with your client ID to authenticate your requests.
Headers
x-client-id
string
required
Your client ID. This will be shared with you during onboarding.
x-destination-client-id
string
The client ID of the destination client. This is optional and only used by platform clients. See the Axle for Platforms guide for more information.
Path Parameters
policyId
string
required
The unique ID for the policy to execute the action on.
Body
application/json
operation
enum<string>
required
The policy update operation to execute.
Available options:
update-third-party
input
object
Details for the insurance carrier, overriding your policy update configuration. An insurance carrier may require a field or not apply it; see Input.
Show child attributes
Response
The policy update was successfully created and is being processed.
success
boolean
Indicates whether the operation was performed successfully.
Example:
true
data
object
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Axle","colors":{"primary":"#3F3F46","light":"#D4D4D8","dark":"#27272A"},"logo":{"light":"https://mintcdn.com/axle/enJXHO5JjjypOw69/logo/light.svg?fit=max\u0026auto=format\u0026n=enJXHO5JjjypOw69\u0026q=85\u0026s=62b3826a6d7c78b1f559063f2c2d3f00","dark":"https://mintcdn.com/axle/enJXHO5JjjypOw69/logo/dark.svg?fit=max\u0026auto=format\u0026n=enJXHO5JjjypOw69\u0026q=85\u0026s=b60a327c63083ec273936a7cb95a2759"},"favicon":"https://mintcdn.com/axle/jvr_RjEwsLPkmitD/favicon-lg.png?fit=max\u0026auto=format\u0026n=jvr_RjEwsLPkmitD\u0026q=85\u0026s=2fcaf929965104a4df7633dd76b9325a","api":{"openapi":"openapi.yaml","mdx":{"server":["https://api.axle.insure","https://sandbox.axle.insure"]}},"appearance":{"default":"light"},"background":{"color":{"dark":"#121212"}},"navbar":{"links":[{"href":"https://status.axle.insure","label":"Status"},{"href":"https://www.ycombinator.com/companies/axle/jobs","label":"We're hiring!"}],"primary":{"type":"button","label":"Get Started","href":"https://www.axle.insure/contact"}},"footer":{"socials":{"x":"https://x.com/axlelabs","linkedin":"https://www.linkedin.com/company/axle-labs","website":"https://www.axle.insure/"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Get Started","icon":"rocket-launch","href":"https://www.axle.insure/contact"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"axle","hasAudioNarration":false,"actualSubdomain":"axle","customDomains":["docs.axle.insure"],"gitSource":{"type":"github","owner":"axle-labs","repo":"axle","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af799f9458d75a00de86389","clientVersion":"0.0.4138","searchFilterCounts":[{"language":"default","tag":"Documentation","count":55},{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Guides","count":21},{"language":"default","tag":"Sandbox","count":6},{"language":"default","tag":"Validation","count":6},{"language":"default","tag":"Policies","count":5},{"language":"default","tag":"Axle Ignition","count":5},{"language":"default","tag":"Templates","count":4},{"language":"default","tag":"Webhooks","count":4},{"language":"default","tag":"Policy Updates","count":4}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@axle.insure","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@font-face{font-family:\"Suisse Intl\";src:url(https://uploads-ssl.webflow.com/62c9a8ebe81984320aaa6d60/63870e3e7d02c82500d5b032_SuisseIntl-Regular.woff2)\n format(\"woff2\"),\n url(https://uploads-ssl.webflow.com/62c9a8ebe81984320aaa6d60/63870e3e7d02c82500d5b032_SuisseIntl-Regular.woff)\n format(\"woff\");font-weight:300;font-style:normal}@font-face{font-family:\"Suisse Intl\";src:url(https://uploads-ssl.webflow.com/62c9a8ebe81984320aaa6d60/63870ec9d6797e86085b84fa_SuisseIntl-SemiBold.woff2)\n format(\"woff2\"),\n url(https://uploads-ssl.webflow.com/62c9a8ebe81984320aaa6d60/63870ec9d6797e86085b84fa_SuisseIntl-SemiBold.woff)\n format(\"woff\");font-weight:600;font-style:normal}body{font-family:\"Suisse Intl\", \"Helvetica\", \"Arial\", sans-serif;font-feature-settings:\"salt\";-o-font-feature-settings:\"salt\";-moz-font-feature-settings:\"salt\";-webkit-font-feature-settings:\"salt\"}.axle-chips{display:inline-flex;flex-wrap:wrap;gap:6px;margin:0 0 4px}.axle-chip{display:inline-flex;align-items:center;padding:2px 8px;border-radius:6px;font-size:0.75rem;font-weight:600;line-height:1.5;letter-spacing:0.01em}.axle-chip.all{background:#eef2f6;color:#475569}.axle-chip.auto{background:#e6eefe;color:#1d4ed8}.axle-chip.home{background:#e7f6ec;color:#15803d}.axle-chip.condo{background:#f1ecfd;color:#6d28d9}.axle-chip.planned,.axle-chip.research{--chip-icon: none}.axle-chip.planned::before,.axle-chip.research::before{content:\"\";flex:none;width:12px;height:12px;margin-right:4px;background-color:currentColor;-webkit-mask:var(--chip-icon) no-repeat center / contain;mask:var(--chip-icon) no-repeat center / contain}.axle-chip.planned{background:#fef3c7;color:#b45309;--chip-icon: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='10'/%3E%3Cpolyline points='12 6 12 12 16 14'/%3E%3C/svg%3E\")}.axle-chip.research{background:#ccfbf1;color:#0f766e;--chip-icon: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M10 2v7.527a2 2 0 0 1-.211.896L4.72 20.55a1 1 0 0 0 .9 1.45h12.76a1 1 0 0 0 .9-1.45l-5.069-10.127A2 2 0 0 1 14 9.527V2'/%3E%3Cpath d='M8.5 2h7'/%3E%3Cpath d='M7 16h10'/%3E%3C/svg%3E\")}.dark .axle-chip.all{background:rgba(148, 163, 184, 0.18);color:#cbd5e1}.dark .axle-chip.auto{background:rgba(59, 130, 246, 0.20);color:#93c5fd}.dark .axle-chip.home{background:rgba(34, 197, 94, 0.18);color:#86efac}.dark .axle-chip.condo{background:rgba(139, 92, 246, 0.20);color:#c4b5fd}.dark .axle-chip.planned{background:rgba(245, 158, 11, 0.18);color:#fcd34d}.dark .axle-chip.research{background:rgba(20, 184, 166, 0.20);color:#5eead4}"}],"page":{"pagePath":"api-reference/policies/request-policy-update","slug":"/api-reference/policies/request-policy-update","pageMetadata":{"openapi":"POST /policies/{policyId}/updates","title":"Request Policy Update","description":"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request.\n\nFor more details on supported operations and error codes, see the [Policy Updates](/guides/policy-updates) guide.","href":"/api-reference/policies/request-policy-update"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"For more details on supported operations and error codes, see the \", _jsx(_components.a, {\n href: \"/guides/policy-updates\",\n children: \"Policy Updates\"\n }), \" guide.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"POST /policies/{policyId}/updates","title":"Request Policy Update","description":"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request.\n\nFor more details on supported operations and error codes, see the [Policy Updates](/guides/policy-updates) guide.","href":"/api-reference/policies/request-policy-update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Request Policy Update","description":"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request.\n\nFor more details on supported operations and error codes, see the [Policy Updates](/guides/policy-updates) guide.","operationId":"RequestPolicyUpdate","parameters":["5c92e39c-bfee-4649-a06f-a5aafe08f91a","fd5a094c-ff8a-4830-b55c-824faa645917"],"requestBody":"a584dd05-6a31-4a08-b523-a00a19eedc10","responses":{"200":"942022ee-ae1b-4c91-af66-039609d501f3","400":"9893ee6c-07fb-4bc4-96a0-6bb60a1ef915","409":"03ba3241-2a93-465e-95d8-9b50d6c5b887","500":"608057c1-9037-4bed-8400-45709037741c"},"deprecated":false,"tags":["Policies"],"method":"post","type":"path","servers":["8144ea70-9175-4fb8-b0d9-148a1c60b10f","3758e428-3685-4602-b3d1-a2a7a0099d59"],"security":["ff7f490c-4d7f-49bf-8f30-510543322227"],"path":"/policies/{policyId}/updates","baseUrlOptions":["https://sandbox.axle.insure","https://api.axle.insure"],"title":"Request Policy Update","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5c92e39c-bfee-4649-a06f-a5aafe08f91a":{"name":"x-client-id","in":"header","required":true,"schema":{"type":"string","isRequired":true,"description":"Your client ID. This will be shared with you during onboarding.","uniqueKey":"","typeLabel":"string"},"description":"Your client ID. This will be shared with you during onboarding."},"fd5a094c-ff8a-4830-b55c-824faa645917":{"name":"x-destination-client-id","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"The client ID of the destination client. This is optional and only used by platform clients. See the [Axle for Platforms](/guides/platform-integration) guide for more information.","uniqueKey":"","typeLabel":"string"},"description":"The client ID of the destination client. This is optional and only used by platform clients. See the [Axle for Platforms](/guides/platform-integration) guide for more information."},"b67bb4f6-fb13-4ac5-b5c3-b26fc8ddf5dd":{"name":"policyId","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The unique ID for the policy to execute the action on.","uniqueKey":"","typeLabel":"string"},"description":"The unique ID for the policy to execute the action on."}},"requestBody":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["operation"],"properties":{"operation":{"type":"string","description":"The policy update operation to execute.","enum":["update-third-party"],"isRequired":true,"uniqueKey":"operation","typeLabel":"enum\u003cstring>"},"input":{"type":"object","additionalProperties":false,"description":"Details for the insurance carrier, overriding your policy update configuration. An insurance carrier may require a field or not apply it; see [Input](/guides/policy-updates/request#input).","properties":{"effectiveDate":{"type":"string","format":"date","description":"The date the change should take effect, as `YYYY-MM-DD`. Defaults to the insurance carrier's own change date.","example":"2026-12-01","uniqueKey":"input.effectiveDate","typeLabel":"string\u003cdate>"},"loanNumber":{"type":"string","description":"The loan number to record with the change. Defaults to the loan number already on the policy.","example":"0022405666","uniqueKey":"input.loanNumber","typeLabel":"string"}},"uniqueKey":"input","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"operation":"update-third-party","input":{"effectiveDate":"2026-12-01","loanNumber":"0022405666"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"942022ee-ae1b-4c91-af66-039609d501f3":{"headers":{"x-axle-request-id":{"description":"A unique identifier generated per request. Include this value when contacting Axle support to help us locate your exact request.","schema":{"type":"string"},"example":"req_V1StGXR8_Z5jdHi6B-myT"}},"description":"The policy update was successfully created and is being processed.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"title":"Success","type":"boolean","description":"Indicates whether the operation was performed successfully.","x-internal":false,"example":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the created policy update.","example":"plu_mZj6YGXhQyQnccN97aXbq","uniqueKey":"data.id","typeLabel":"string"},"processesInstantly":{"type":"boolean","description":"Whether the policy update is processed instantly by the insurance carrier. See details on processing behavior via [webhooks](/guides/policy-updates/events).","uniqueKey":"data.processesInstantly","typeLabel":"boolean"},"unsupportedInputs":{"type":"array","items":{"type":"string","uniqueKey":"data.unsupportedInputs.items.[INDEX]","typeLabel":"string"},"description":"Fields of `input` the policy's insurance carrier doesn't apply, so they weren't sent. Empty when everything was sent. See [Input](/guides/policy-updates/request#input).","example":[],"uniqueKey":"data.unsupportedInputs","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"id":"plu_mZj6YGXhQyQnccN97aXbq","processesInstantly":true,"unsupportedInputs":[]}}}},"exampleType":"generated"}},"exampleType":"generated"},"9893ee6c-07fb-4bc4-96a0-6bb60a1ef915":{"headers":{"x-axle-request-id":{"description":"A unique identifier generated per request. Include this value when contacting Axle support to help us locate your exact request.","schema":{"type":"string"},"example":"req_V1StGXR8_Z5jdHi6B-myT"}},"description":"The request is invalid. See the error message for details.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"errorCode":{"type":"string","description":"A machine-readable code identifying the error: `policy-update-not-supported` or `policy-update-input-required`.","example":"policy-update-not-supported","uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","description":"A human-readable description of the error.","example":"Policy update \"update-third-party\" is not supported for this policy.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errorCode":"policy-update-not-supported","message":"Policy update \"update-third-party\" is not supported for this policy."}}},"exampleType":"generated"}},"exampleType":"generated"},"03ba3241-2a93-465e-95d8-9b50d6c5b887":{"headers":{"x-axle-request-id":{"description":"A unique identifier generated per request. Include this value when contacting Axle support to help us locate your exact request.","schema":{"type":"string"},"example":"req_V1StGXR8_Z5jdHi6B-myT"}},"description":"Another policy update on this policy is still in progress.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"errorCode":{"type":"string","example":"policy-update-in-progress","uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","example":"A policy update is already in progress for this policy. Please try again later.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errorCode":"policy-update-in-progress","message":"A policy update is already in progress for this policy. Please try again later."}}},"exampleType":"generated"}},"exampleType":"generated"},"608057c1-9037-4bed-8400-45709037741c":{"headers":{"x-axle-request-id":{"description":"A unique identifier generated per request. Include this value when contacting Axle support to help us locate your exact request.","schema":{"type":"string"},"example":"req_V1StGXR8_Z5jdHi6B-myT"}},"description":"An unexpected server error occurred.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"errorCode":{"type":"string","example":"default","uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","example":"Oops something went wrong. Please try again later.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errorCode":"default","message":"Oops something went wrong. Please try again later."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ff7f490c-4d7f-49bf-8f30-510543322227":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-client-secret","description":"Your secret API key. This will be shared with you during onboarding and should be considered sensitive - it’s a password after all! Your secret will be matched with your client ID to authenticate your requests.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"8144ea70-9175-4fb8-b0d9-148a1c60b10f":{"description":"Sandbox","url":"https://sandbox.axle.insure"},"3758e428-3685-4602-b3d1-a2a7a0099d59":{"description":"Production","url":"https://api.axle.insure","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-client-secret","description":"Your secret API key. This will be shared with you during onboarding and should be considered sensitive - it’s a password after all! Your secret will be matched with your client ID to authenticate your requests.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-client-secret","type":"string","description":"Your secret API key. This will be shared with you during onboarding and should be considered sensitive - it’s a password after all! Your secret will be matched with your client ID to authenticate your requests.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-client-secret"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"axle","siteName":"Axle","title":"Request Policy Update - Axle","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T23:15:11.974Z","originalFileLocation":"api-reference/policies/request-policy-update.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request. For more details on supported operations and error codes, see the Policy Updates guide.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Axle\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Request Policy Update - Axle\">\u003cmeta data-mint-head property=\"og:description\" content=\"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request. For more details on supported operations and error codes, see the Policy Updates guide.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Axle\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.axle.insure/api-reference/policies/request-policy-update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://axle.mintlify.site/_mintlify/api/og/v2?division=Policies\u0026amp;title=Request+Policy+Update\u0026amp;description=Request+a+change+to+a+policy+on+behalf+of+your+user.+Once+submitted%2C+Axle+will+process+the+request.%0A%0AFor+more+details+on+supported+operations+and+error+codes%2C+s\u0026amp;theme=1a7b86b33398f79d40b84655\u0026amp;signature=fa5089fe9bbddfcf4c999756054eeb504ee8530d46f59946fb8ca575eff788dc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Request Policy Update - Axle\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request. For more details on supported operations and error codes, see the Policy Updates guide.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://axle.mintlify.site/_mintlify/api/og/v2?division=Policies\u0026amp;title=Request+Policy+Update\u0026amp;description=Request+a+change+to+a+policy+on+behalf+of+your+user.+Once+submitted%2C+Axle+will+process+the+request.%0A%0AFor+more+details+on+supported+operations+and+error+codes%2C+s\u0026amp;theme=1a7b86b33398f79d40b84655\u0026amp;signature=fa5089fe9bbddfcf4c999756054eeb504ee8530d46f59946fb8ca575eff788dc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/axle/DXTH79GIjAle_zmy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Axle\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3F3F46\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.axle.insure/api-reference/policies/request-policy-update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/policies/request-policy-update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.axle.insure/#organization\",\"name\":\"Axle\",\"url\":\"https://docs.axle.insure\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/axle/enJXHO5JjjypOw69/logo/light.svg?fit=max\u0026auto=format\u0026n=enJXHO5JjjypOw69\u0026q=85\u0026s=62b3826a6d7c78b1f559063f2c2d3f00\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.axle.insure#website\",\"name\":\"Axle\",\"url\":\"https://docs.axle.insure\",\"publisher\":{\"@id\":\"https://docs.axle.insure/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.axle.insure/api-reference/policies/request-policy-update#webpage\",\"url\":\"https://docs.axle.insure/api-reference/policies/request-policy-update\",\"name\":\"Request Policy Update\",\"description\":\"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request. For more details on supported operations and error codes, see the Policy Updates guide.\",\"dateModified\":\"2026-11-13T23:15:11.974Z\",\"isPartOf\":{\"@id\":\"https://docs.axle.insure#website\"},\"breadcrumb\":{\"@id\":\"https://docs.axle.insure/api-reference/policies/request-policy-update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.axle.insure/api-reference/policies/request-policy-update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.axle.insure/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Policies\",\"item\":\"https://docs.axle.insure/api-reference/policies/policy\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Request Policy Update\",\"item\":\"https://docs.axle.insure/api-reference/policies/request-policy-update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.axle.insure/api-reference/policies/request-policy-update#apireference\",\"headline\":\"Request Policy Update\",\"name\":\"Request Policy Update\",\"description\":\"Request a change to a policy on behalf of your user. Once submitted, Axle will process the request. For more details on supported operations and error codes, see the Policy Updates guide.\",\"url\":\"https://docs.axle.insure/api-reference/policies/request-policy-update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.axle.insure/api-reference/policies/request-policy-update#webpage\"},\"dateModified\":\"2026-11-13T23:15:11.974Z\",\"publisher\":{\"@id\":\"https://docs.axle.insure/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.axle.insure#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Axle\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Axle\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/policies/request-policy-update.md","siteName":"Axle","nav":{"global":{"anchors":[{"anchor":"Get Started","icon":"rocket-launch","href":"https://www.axle.insure/contact"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Home","pages":[{"title":"Welcome","href":"/welcome"},{"title":"Security","href":"/security"},{"title":"Changelog","href":"/changelog"}]},{"group":"Guides","pages":[{"title":"Quickstart","href":"/guides/quickstart"},{"group":"Axle Ignition","pages":[{"title":"Initialize","href":"/guides/initialize-ignition"},{"title":"Proxy","href":"/guides/proxy-ignition"},{"title":"Events","href":"/guides/ignition-events"},{"title":"Results","href":"/guides/completion-types"},{"title":"Optimizing conversion with Axle Ignition","sidebarTitle":"Optimizing conversion","href":"/guides/optimizing-ignition-conversion"}]},{"title":"Axle for Platforms","href":"/guides/platform-integration"},{"group":"Monitoring","pages":[{"title":"Overview","href":"/guides/monitoring"},{"title":"Account events","href":"/guides/account-events"},{"title":"Policy events","href":"/guides/policy-events"}]},{"group":"Axle Validation","pages":[{"title":"Policy Validation","href":"/guides/validate/policy-validation"},{"title":"Policy Validation with Templates","href":"/guides/validate/policy-validation-with-template"}]},{"title":"Widgets","href":"/guides/widgets"},{"group":"Policy Updates","pages":[{"title":"Overview","href":"/guides/policy-updates"},{"title":"Request a policy update","href":"/guides/policy-updates/request"},{"group":"Operations","pages":[{"title":"Update third party","href":"/guides/policy-updates/update-third-party"}]},{"title":"Policy update events","href":"/guides/policy-updates/events"}]},{"group":"Sandbox","pages":[{"title":"Testing Ignition","href":"/guides/sandbox/ignition-completion"},{"title":"Monitoring notifications","href":"/guides/sandbox/monitoring-notifications"},{"title":"Policy updates","href":"/guides/sandbox/policy-updates"},{"title":"Validate Policy with Template","href":"/guides/sandbox/validate-policy-with-template"}]}]},{"group":"API Reference","pages":[{"title":"Overview","href":"/api-reference/overview"},{"group":"Ignition","pages":[{"openapi":"POST /ignition","title":"Start Ignition","href":"/api-reference/ignition/start-ignition"},{"openapi":"POST /ignition/{ignitionToken}/proxy","title":"Proxy Ignition","href":"/api-reference/ignition/proxy-ignition"}]},{"group":"Tokens","pages":[{"openapi":"POST /token/exchange","title":"Exchange Token","href":"/api-reference/tokens/exchange-token"},{"openapi":"POST /token/descope","title":"Descope Token","href":"/api-reference/tokens/descope-token"}]},{"group":"Accounts","pages":[{"title":"The Account object","href":"/api-reference/accounts/account"},{"openapi":"GET /accounts/{id}","title":"Get Account","href":"/api-reference/accounts/get-account"}]},{"group":"Policies","pages":[{"title":"The Policy object","href":"/api-reference/policies/policy"},{"title":"Coverages","href":"/api-reference/policies/coverages"},{"openapi":"GET /policies/{policyId}","title":"Get Policy","href":"/api-reference/policies/get-policy"},{"openapi":"GET /policies/{policyId}/report","title":"Get Policy Report","description":"The Get Policy Report endpoint returns a PDF or image report of the requested Policy object. Please refer to the [Policy](/api-reference/policies/policy) object for a detailed description of each field.","href":"/api-reference/policies/get-policy-report"},{"openapi":"POST /policies/{policyId}/updates","title":"Request Policy Update","href":"/api-reference/policies/request-policy-update"}]},{"group":"Carriers","pages":[{"openapi":"GET /carriers/{id}","title":"Get Carrier","description":"The Get Carrier endpoint returns a Carrier object that include additional details (such as image) about an Axle-supported insurance carrier.\n\nThe `id` path parameter accepts either the Axle carrier ID or the carrier's NAIC code. For example, `/carriers/state-farm` and `/carriers/10739` are both valid requests.\n\n**Note**: this is only available for carriers that are listed on Account or Policy objects that are generated via Ignition result=`link`.","href":"/api-reference/carriers/get-carrier"},{"openapi":"GET /carriers","title":"Get Carriers","href":"/api-reference/carriers/get-carriers"}]},{"group":"Platform","pages":[{"openapi":"POST /platform/clients","title":"Create Client","href":"/api-reference/platform/create-client"},{"openapi":"GET /platform/clients","title":"Get Clients","href":"/api-reference/platform/get-clients"},{"openapi":"POST /platform/validation/templates","title":"Create Template","href":"/api-reference/platform/create-templates"}]},{"group":"Sandbox","pages":[{"openapi":"POST /sandbox/accounts/{id}/event","title":"Trigger Account event","href":"/api-reference/sandbox/trigger-account-event"},{"openapi":"POST /sandbox/policies/{policyId}/event","title":"Trigger Policy event","href":"/api-reference/sandbox/trigger-policy-event"}]},{"group":"Validation","pages":[{"openapi":"POST /policies/{policyId}/validate","title":"Validate Policy","href":"/api-reference/validation/validate-policy"},{"openapi":"POST /policies/{policyId}/validate/{templateId}","title":"Validate Policy with Template","href":"/api-reference/validation/validate-policy-template"},{"group":"Templates","pages":[{"openapi":"POST /validation/templates","title":"Create Template","href":"/api-reference/validation/templates/create-template"},{"openapi":"GET /validation/templates/{templateId}","title":"Get Template","href":"/api-reference/validation/templates/get-template"},{"openapi":"POST /validation/templates/{templateId}","title":"Update Template","href":"/api-reference/validation/templates/update-template"},{"openapi":"GET /validation/templates","title":"Get Templates","href":"/api-reference/validation/templates/get-templates"}]}]},{"group":"Widgets","pages":[{"openapi":"POST /widgets","title":"Start Widget","href":"/api-reference/widgets/start-widget"}]},{"group":"Webhooks","pages":[{"openapi":"openapi.yaml webhook ignitionEvents","title":"Ignition Events","href":"/api-reference/webhooks/ignition-events"},{"openapi":"openapi.yaml webhook accountEvents","title":"Account Events","href":"/api-reference/webhooks/account-events"},{"openapi":"openapi.yaml webhook policyEvents","title":"Policy Events","href":"/api-reference/webhooks/policy-events"},{"openapi":"openapi.yaml webhook policyUpdateEvents","title":"Policy Update Events","href":"/api-reference/webhooks/policy-update-events"}]}]},{"group":"Advanced","pages":[{"title":"MCP","href":"/advanced/mcp"}]}]},{"tab":"Authorization","hidden":true,"pages":[{"title":"Authorization","href":"/dashboard/rbac"}]},{"tab":"Carriers","hidden":true,"pages":[{"title":"Carriers","href":"/carriers/overview"}]}]},"basePath":"","title":"Request Policy Update - Axle","buildId":"dpl_715YoAgvjTGBDdo8RtXmHKM22b5p","deploymentId":"dpl_715YoAgvjTGBDdo8RtXmHKM22b5p","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BvKnMd7F.js","utils-BMt52org.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CGXZuDGO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dl57XWH2.js","snippetPresets-CWd8CxSk.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BR-Wkc_D.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-YMmi08aZ.js","shallow-DBC1OB78.js","getApiPlaygroundDisplay-Be7mmEzP.js","CodeSnippet-B14o1TgQ.js","CodeSnippets-CJ2q3fTq.js","Page-Chgj7sZe.js","getPastedJson-DnpLXm8x.js","icon-BpkSFtdK.js","MethodPill-BO3zPf-g.js","DuplicateIcon-Bib3qwfw.js","createIcon-CY2noFo3.js","DynamicMarkdown-TAXIW2vN.js","SectionHeading-Dfs3Fmfw.js","axios-vUo_bRtp.js","Markdown-CGAo_eqA.js","clsx-BNa-H6W6.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-r2tNEC1n.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-B7oWe6jc.js"]}