Editar artículo por bloque

PATCH

/api/blog/{article_id}/blocks

Edición incremental: aplica una lista de operaciones (replace/insert_after/insert_before/append/prepend/delete/update_text) sobre los bloques Editor.js del artículo, sin reenviar el content completo. Los bloques se localizan por block_id (ver GET /api/blog/{article_id}?blocks=outline) o por index. expected_blocks_count es opcional y protege contra ediciones concurrentes (409 STALE_CONTENT si no coincide).

Solicitud

Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200

application/json

Bodyapplication/json

🟠400

🟠404

🟠409

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://app.mgpanel.co/api/blog/6810aae68cde71cc5bcc3d01/blocks' \
--header 'X-Account-Nick: {{ACCOUNT_NICK}}' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "ops": [
        {
            "op": "replace",
            "block_id": "aB3xY9kLm2",
            "block": {
                "type": "paragraph",
                "data": {
                    "text": "Texto actualizado del párrafo."
                }
            }
        }
    ],
    "expected_blocks_count": 6
}'

Ejemplo de Respuesta

{
    "success": true,
    "message": "Bloques actualizados exitosamente",
    "article_id": "6810aae68cde71cc5bcc3d01",
    "blocks_count": 6,
    "applied_ops": [
        {
            "op": "replace",
            "index": 2
        }
    ],
    "blocks_outline": [
        {
            "index": 0,
            "block_id": "z9Qw1eRtY8",
            "type": "header",
            "preview": "Introducción"
        }
    ]
}

Modificado en 2026-09-03 16:20:03

Crear artículo

Listar categorías de blog