# Update Dispute Settings

PUT /api/v2/projects/{projectId}/dispute-settings

Updates dispute settings. Omitted fields stay as they are. Send null to clear a text field.

## Request

- projectId: string, path, required — ID of the project.
- changes: object, required — Settings to change. Omitted fields stay as they are.
  - aiContext: string — Extra instructions included when drafting dispute evidence. Null clears them.
  - aiContextEnabled: boolean — Whether the evidence draft uses aiContext.
  - autoSubmit: boolean — Whether evidence is submitted to Stripe as soon as it is ready.
  - cancellationPolicyDisclosure: string — Cancellation-policy text sent with evidence. Null clears it.
  - checkoutTermsImageLabel: string — Caption for the checkout-terms screenshot. Null clears it.
  - checkoutTermsImageUrl: string — HTTPS URL of the checkout-terms screenshot. Null clears it.
  - customDataEndpointSecret: string — Shared secret sent when Saasco calls customDataEndpointUrl. Null clears it.
  - customDataEndpointUrl: string — HTTPS URL Saasco calls for extra evidence before drafting. Null clears it.
  - customEndpointEnabled: boolean — Whether the custom evidence endpoint is called.
  - notificationEmailOverride: string — Address that receives dispute outcome mail instead of the project default. Null clears the override.
  - policiesEnabled: boolean — Whether refund and cancellation policy text is included in evidence.
  - productDescriptionOverride: string — Product description sent with evidence instead of the Stripe charge text. Null clears it.
  - refundPolicyDisclosure: string — Refund-policy text sent with evidence. Null clears it.
  - stripeWebhookEndpointId: string — Stripe webhook endpoint id that delivers dispute events. Set by provisioning; send 
…

## Response

- 200: Successful response
  - aiContext: string, required — Extra instructions included when drafting dispute evidence. Null clears them.
  - aiContextEnabled: boolean, required, default false — Whether the evidence draft uses aiContext.
  - autoSubmit: boolean, required, default true — Whether evidence is submitted to Stripe as soon as it is ready.
  - cancellationPolicyDisclosure: string, required — Cancellation-policy text sent with evidence. Null clears it.
  - checkoutTermsImageLabel: string, required — Caption for the checkout-terms screenshot. Null clears it.
  - checkoutTermsImageUrl: string, required — HTTPS URL of the checkout-terms screenshot. Null clears it.
  - customDataEndpointSecret: string, required — Shared secret sent when Saasco calls customDataEndpointUrl. Null clears it.
  - customDataEndpointUrl: string, required — HTTPS URL Saasco calls for extra evidence before drafting. Null clears it.
  - customEndpointEnabled: boolean, required, default false — Whether the custom evidence endpoint is called.
  - notificationEmailOverride: string, required — Address that receives dispute outcome mail instead of the project default. Null clears the override.
  - policiesEnabled: boolean, required, default false — Whether refund and cancellation policy text is included in evidence.
  - productDescriptionOverride: string, required — Product description sent with evidence instead of the Stripe charge text. Null clears it.
  - refundPolicyDisclosure: string, required — Refund-policy text sent with evidence. Null clears it.
  - stripeWebhookEndpointId: string, required
…
