postlineDocs
GuiasReferência da APIMCPChangelogAbrir o app

Atualizar um artigo

PATCH
/api/v1/articles/{id}

Salva uma nova revisão sobre a que você leu (revision); o que você não manda fica. coverImageId define a capa. Um artigo aprovado ou agendado volta a rascunho; um em revisão só muda por quem pode aprovar.

Permissão: articles:write.

Autorização

apiToken
headerAutorizaçãoBearer <token>

Token de API (pl_live_…) de Organização › Chaves de API, com suas permissões e limite de 60 chamadas por minuto. Um token de projeto trabalha no seu projeto; um token de todos os projetos indica um com projectId.

Parâmetros de caminho

id*string

O id do artigo (ou, com o token de leitura, o slug).

Corpo da requisição

application/json
  1. body
revision?integer

A revisão que você leu; uma mais nova é conflito.

Intervalo1 <= value
markdown?string

O corpo: títulos ## e ###, parágrafos, listas - ou 1., citações >, negrito, código, links e imagens como alt de Enviar imagem. Uma primeira linha # é o título.

Tamanholength <= 200000
title?string
Tamanho1 <= length <= 200
slug?string

palavras-minusculas-com-hifens

Padrão^[a-z0-9]+(?:-[a-z0-9]+)*$
Tamanholength <= 120
summary?string
Tamanholength <= 1000
seoTitle?string
Tamanholength <= 200
seoDescription?string
Tamanholength <= 500
coverImageId?string

De Enviar imagem.

Tamanho1 <= length <= 64

Corpo da resposta

OK

application/json
  1. response
Exemplo de requisição
curl -X PATCH 'https://app.postline.com.br/api/v1/articles/string' \  -H 'Authorization: Bearer pl_live_…' \  -H 'Content-Type: application/json' \  -d '{  "revision": 3,  "seoTitle": "Cut churn in 30 days"}'
Exemplo de resposta
{  "revision": 4,  "status": "draft",  "slug": "cut-churn-first-30-days",  "droppedImages": []}