# Update a dispute

Updates the specified Issuing `Dispute` object by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Properties on the `evidence` object can be unset by passing in an empty string.

## Prerequisites

Before you can run the following code snippet, you need to call these APIs with the provided parameters to set up the prerequisite API object(s).

1. Create a Payment Intent with a dispute inquiry
POST /v1/payment_intents {"amount":100,"currency":"usd","payment_method_types":["card"],"payment_method":"pm_card_createDisputeInquiry","confirm":true,"description":"(created by Stripe Docs)"}

## Request

```curl
curl https://api.stripe.com/v1/issuing/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>" \
  -d "evidence[reason]=not_received" \
  -d "evidence[not_received][expected_at]=1590000000" \
  -d "evidence[not_received][explanation]=" \
  -d "evidence[not_received][product_description]=Baseball cap" \
  -d "evidence[not_received][product_type]=merchandise"
```

### Response

```json
{
  "id": "idp_1MykdxFtDWhhyHE1BFAV3osZ",
  "object": "issuing.dispute",
  "amount": 100,
  "created": 1681947753,
  "currency": "usd",
  "evidence": {
    "reason": "not_received",
    "not_received": {
      "expected_at": 1590000000,
      "explanation": "",
      "product_description": "Baseball cap",
      "product_type": "merchandise"
    }
  },
  "livemode": false,
  "metadata": {},
  "status": "unsubmitted",
  "transaction": "ipi_1MykXhFtDWhhyHE1UjsZZ3xQ"
}
```

## Returns

Returns an updated Issuing `Dispute` object if a valid identifier was provided.

## Parameters

- `amount` (integer, optional)
  The dispute amount in the card’s currency and in the [smallest currency unit](https://docs.stripe.com/currencies.md#zero-decimal).

- [`evidence`](https://docs.stripe.com/api/issuing/disputes/update.md?query=evidence) (object, optional)
  Evidence provided for the dispute.

- `metadata` (map, optional)
  Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.