---
title: "Update funds recovery"
method: PATCH
path: "/v1/pix/funds-recoveries/{funds_recovery_id}"
tags: ["Funds recovery"]
---

# Update funds recovery

`PATCH /v1/pix/funds-recoveries/{funds_recovery_id}`

## Request

- Base URL: `https://sandbox.pismolabs.io/pix-dict`
- URL: `https://sandbox.pismolabs.io/pix-dict/v1/pix/funds-recoveries/{funds_recovery_id}`
- Auth: HTTP bearer

Update some funds recovery fields. 

**Note:** The update is only possible when the record is in `CREATED`, `TRACKED`, or `AWAITING_ANALYSIS` states.

## Path parameters

- `funds_recovery_id` string, required

## Headers

- `Authorization` string, required
- `x-tenant` string, required
- `x-account-id` string
- `Idempotency-Key` string, required
- `x-cid` string

## Request body

- FundsRecoveryUpdateRequest
  - `id` string, required: Funds recovery identifier. Returned from the [Create funds recovery](ref:post-create-funds-recovery) endpoint.
  - `contact_information` ContactInformation
    - `phone` string, required: Contact phone number
    - `email` string, required: Contact email
  - `situation_type` 'SCAM' | 'ACCOUNT_TAKEOVER' | 'COERCION' | 'FRAUDULENT_ACCESS' | 'OTHER' | 'UNKNOWN': Situation type: * `SCAM` - Scam/fraud through social engineering * `ACCOUNT_TAKEOVER` - Unauthorized transaction without digital authentication * `COERCION` - Coercion crime (kidnapping, extortion) * `FRAUDULENT_ACCESS` - Fraudulent access and authorization (phishing, stolen password) | * `OTHER` - Other cases. This option **REQUIRES** you pass `report_details`. * `UNKNOWN` - Unknown state When the contested transaction is a reversal, the DICT operating manual requires `situation_type` to be `OTHER`, which in turn makes `report_details` mandatory.
  - `report_details` string: Details about report

## Response `202`

OK - success

## Other responses

- `403`: Forbidden
- `500`: Internal Server Error
- `502`: Bad Gateway
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/pismo/apis/instant-payments-pix-management.md) - [All operations](https://skmtc.dev/pismo/apis/instant-payments-pix-management/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/instant-payments-pix-management/revisions/eb540c289547?raw)