Ir al contenido

Actualizar carpetas de trabajo

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.

Ejemplo de Petición

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"'

{
    "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
}

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

{
    "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.

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.

Volver al listado