Novidades

17 de outubro de 2026Copiar link

API v1 redesignCopiar link

Um nome por conceito, as mesmas operações na API REST e no servidor MCP. Mudanças que quebram:

• Rotas: /contents, /drafts, /media, /posts e /images/{project}/{asset} deram lugar a /projects, /articles (rascunho é um status), /articles/{id}/comments, /comments/{id}/resolve, /posts (posts sociais, format linkedin, x ou carousel), /images, /topics, /calendar e /results. Veja a referência.
• Leitura do site: GET /articles e GET /articles/{slug} com o token de leitura, que só vê os artigos publicados do projeto. Imagens públicas em /api/v1/images/{id}.
• Permissões: projects:read, articles:read, articles:write, articles:approve, posts:read, posts:write, images:write, comments:read, comments:write, calendar:read e results:read. Os tokens existentes foram convertidos.
• Prefixos: pl_live_ (API), pl_read_ (leitura do site), whsec_ (webhooks). Nenhum cp_ é aceito; o cabeçalho X-Postline-Project saiu (um token de todos os projetos manda projectId).
• Formato: toda lista aceita limit e cursor e responde { data, nextCursor }; todo erro é { error: { code, message, param?, requestId } }, com x-request-id em toda resposta.
• Eventos: article.published, article.review_requested, article.scheduled, post.scheduled, post.published, delivery.failed, credits.low (com data.percent) e ping; os do site são article.published, article.updated, article.unpublished, article.deleted e article.slug_changed, com data.articleId. Só o envelope do Standard Webhooks; o corpo antigo e os cabeçalhos Postline-Signature e X-Postline-Signature saíram.
• MCP: as ferramentas têm o nome da operação (list_articles, create_post, generate_post…); veja Ferramentas.
• Pacotes 0.2.0: @postline/sdk (articles.list e articles.get), @postline/next (articles() e article(slug), só o envelope) e @postline/cli. Um site instalado antes precisa atualizar os pacotes e rodar npx @postline/cli init de novo (veja Eventos do site).
• Documentação para desenvolvedores em docs.postline.com.br, em português e inglês, com a referência da API gerada dos schemas reais e o documento OpenAPI 3.1 em /openapi.json.

16 de outubro de 2026Copiar link

• Servidor MCP 2.0: peças de LinkedIn, carrossel e X (create_*, generate_*, get_piece, update_piece, schedule_piece_destination, render_carousel) e o prompt repurpose-article.
• Criado por agentes de IA: cada projeto escolhe se o trabalho de um assistente sempre passa por revisão, segue a regra do projeto ou vai direto.
• Chaves de assinatura dos webhooks e do site rotacionam com 24 horas em que as duas assinam. @postline/next 0.1.1 aceita previousSecret.
• Permissões dos tokens com nomes em inglês: content:read, drafts:create, media:upload, publishing:request.

14 de outubro de 2026Copiar link

• Webhooks da organização: post.published, review.requested, delivery.failed, post.scheduled e credits.80, assinados com Postline-Signature, com repetição, pausa e reenvio.

12 de outubro de 2026Copiar link

• @postline/cli, @postline/next e @postline/sdk 0.1.0 publicados no npm.