---
title: "Editar una retención"
method: PUT
path: "/retentions/{id}"
tags: ["Retenciones"]
---

# Editar una retención

`PUT /retentions/{id}`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/retentions/{id}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Endpoint que permite actualizar la información de una retención registrada en la cuenta de Alegra.

## Parameters

- `#/paths/~1retentions~1%7Bid%7D/get/parameters/0` (unresolved $ref)

## Request body

- object
  - `name` string
  - `calculatedBy` 'percentage' | 'fixedAmount'
  - `percentage` number
  - `description` string
  - `type` string
  - `status` 'active' | 'inactive'

## Response `200`

Retorna información de una retención

- Schema (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `404` (unresolved $ref)

---

[API](https://skmtc.dev/alegra/apis/configuraciones.md) - [All operations](https://skmtc.dev/alegra/apis/configuraciones/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/configuraciones/revisions/5a651ca3b942?raw)