> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Modificar una recuperación de valores MED > Registra una actualización solo de campos en una recuperación de valores. NUNCA cambia el estado. Las invariantes se validan antes de cualquier llamada al upstream. Un id desconocido devuelve un 404 codificado. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml PUT /v1/med/recoveries/{idRecValores}/amend openapi: 3.0.3 info: title: Plugin BR Pix Directo - API completa description: > API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/med/recoveries/{idRecValores}/amend: put: tags: - MED API summary: Modificar una recuperación de valores MED description: >- Registra una actualización solo de campos en una recuperación de valores. NUNCA cambia el estado. Las invariantes se validan antes de cualquier llamada al upstream. Un id desconocido devuelve un 404 codificado. parameters: - description: The value-recovery GUID. in: path name: idRecValores required: true schema: description: El GUID de la recuperación de valores. type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/AmendRecoveryRequestBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/RecoveryView' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error components: schemas: AmendRecoveryRequestBody: additionalProperties: false properties: contatoEmail: description: Nuevo correo electrónico de contacto del creador. type: string contatoTelefone: description: Nuevo teléfono de contacto del creador. type: string detalhes: description: >- Nuevo detalle de texto libre; obligatorio cuando tpSituacao=4 (Outros). type: string idempotencyKey: description: Clave de idempotencia derivada del negocio (Chave-Idempotencia). type: string tpSituacao: description: Nuevo código de situación (0..5). format: int64 type: integer required: - tpSituacao - idempotencyKey type: object RecoveryView: additionalProperties: false properties: breached: description: >- True cuando el plazo de devolver se ha alcanzado o superado (calculado en el momento de la lectura); false cuando no hay plazo definido. type: boolean contatoEmail: description: Correo electrónico de contacto del creador. type: string contatoTelefone: description: Teléfono de contacto del creador. type: string detalhes: description: Detalle de texto libre (obligatorio cuando tpSituacao=4 Outros). type: string devolverDeadline: description: >- Plazo de devolver de 72 h del lado del creador, desde el cierre de la etapa de Análise; null salvo que esta institución sea el pspCriador en una recuperación Analisada. type: string dtHrCriacao: description: Marca de tiempo de creación en el upstream (RFC 3339 UTC). type: string dtHrUltModificacao: description: >- Marca de tiempo de la última modificación en el upstream (RFC 3339 UTC): la marca de agua. type: string idRecValores: description: GUID de la recuperación de valores (la clave natural). type: string idTransacaoRaiz: description: EndToEndId de la transacción raíz que se está recuperando. type: string pspCriador: description: ISPB del creador de la recuperación. type: string status: description: Código de ciclo de vida stRecValores (0=Criada.. 6=Cancelada). format: int64 type: integer statusDescription: description: Etiqueta legible para humanos de stRecValores. type: string tpSituacao: description: Código de situación (0..5). format: int64 type: integer tpSituacaoDescription: description: Etiqueta legible para humanos de tpSituacao. type: string required: - idRecValores - idTransacaoRaiz - tpSituacao - tpSituacaoDescription - contatoEmail - contatoTelefone - pspCriador - status - statusDescription - dtHrCriacao - dtHrUltModificacao - breached type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, acotado al servicio emisor (formato: -NNNN). type: string detail: description: >- Una explicación legible para humanos específica de esta ocurrencia del problema. type: string errors: description: Lista opcional de detalles de error individuales items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. format: uri type: string status: description: Código de estado HTTP format: int64 type: integer title: description: >- Un resumen breve y legible para humanos del tipo de problema. Este valor no debería cambiar entre ocurrencias del error. type: string type: default: about:blank description: >- Una referencia URI a la documentación legible para humanos del error. format: uri type: string type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticación con token JWT Bearer. Obtén el token desde el endpoint `/v1/login/oauth/access_token` usando credenciales de cliente (`clientId` y `clientSecret`). Incluye el token en el encabezado Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` El token expira después de 3600 segundos (1 hora). ````