# Actualizar carpetas de trabajo

Fuente: /work-folders/work-folders-upload/

Este endpoint permite cambiar el nombre de una carpeta de trabajo y, de forma opcional, reemplazar su logo. Solo el **propietario** de la carpeta puede actualizarla.

### Especificación del Endpoint

**Método:**  PATCH `https://api.digitafirma.com/v1/companies/{company}`

#### Path Parameters

| Parámetro | Tipo | Descripción |
| :- | :- | :- |
| **company** | `string` | **Requerido**. El identificador único de la carpeta de trabajo. |

#### Body (`multipart/form-data`)

| Campo | Tipo | Obligatorio | Descripción |
| :- | :- | :- | :- |
| `name` | `string` | Sí | Nombre de la carpeta de trabajo. No puede ir vacío. Mándalo aunque solo quieras cambiar el logo. |
| `logo` | `file` | No | Imagen del logo, enviada como archivo. **Debe pesar 1 MB o menos.** El nombre del archivo debe incluir su extensión (por ejemplo `logo.png`). Si no lo mandas, se conserva el logo actual. |

> **Precaución**
>
> Este endpoint recibe el cuerpo como `multipart/form-data`, **no como JSON**. Si mandas un JSON, la API no lee los campos y responde con error. El logo se manda como archivo, no como texto en Base64.

> **El logo debe pesar 1 MB o menos**
>
> El archivo `logo` puede pesar como máximo **1 MB (1,048,576 bytes)**. Si pesa más, la API responde con un error `400` y no aplica ningún cambio a la carpeta, ni siquiera el nuevo `name`. Reduce o comprime la imagen antes de enviarla.

***

### Ejemplo de Petición

**cURL**

```bash
curl --location --request PATCH 'https://api.digitafirma.com/v1/companies/ac110005-9f6c-144a-819f-8bef698607b8' \
--header 'X-Api-Key: {X-API-KEY}' \
--form 'name="Carpeta Contratos 2026"' \
--form 'logo=@"/ruta/a/logo.png"'
```

**Respuesta Exitosa (200 OK)**

```json
{
    "data": [
        {
            "id": "ac110005-9f6c-144a-819f-8bef698607b8",
            "type": "company",
            "attributes": {
                "name": "Carpeta Contratos 2026",
                "logo": "ac110005-9f6c-144a-819f-8bef698607b8.png",
                "created_at": "2026-07-22T16:25:50.983113",
                "updated_at": "2026-10-21T16:18:02.665223"
            },
            "links": {
                "self": "/companies/ac110005-9f6c-144a-819f-8bef698607b8"
            }
        }
    ],
    "links": null
}
```

**Error: logo mayor a 1 MB (400)**

```json
{
    "errors": [
        {
            "status": 400,
            "title": "Validation Error",
            "detail": "logo: Selecciona un archivo con un peso inferior a 1MB"
        }
    ]
}
```

**Error: nombre vacío (400)**

```json
{
    "errors": [
        {
            "status": 400,
            "title": "Validation Error",
            "detail": "name: El nombre de la carpeta de trabajo no puede estar vacío"
        }
    ]
}
```

En la respuesta, `attributes.logo` es el nombre del archivo guardado, no la imagen. Para obtener el logo en Base64, consulta [Mostrar una carpeta de trabajo](/work-folders/work-folders-show-folder).

#### Errores

Todos los errores responden con estado `400` y la estructura de los ejemplos anteriores.

| `detail` | Causa |
| :- | :- |
| `name: El nombre de la carpeta de trabajo no puede estar vacío` | El campo `name` llegó vacío. |
| `logo: Selecciona un archivo con un peso inferior a 1MB` | El logo pesa más de 1 MB (1,048,576 bytes). |
| `El usuario no tiene permiso` | La API Key no es del propietario de la carpeta. |
| `Usuario no encontrado` | El usuario de la API Key no pertenece a la carpeta, o la carpeta no existe. |

> **Consejo**
>
> Recuerda incluir siempre el header `X-Api-Key` para autenticar tu solicitud. Si no sabes cómo obtenerlo, revisa la sección de [Uso de tokens](/authentication/using-token).

[Volver al listado](/work-folders/work-folders-list)