Criar um artigo

POST
/api/v1/articles

Cria um artigo a partir de Markdown, sem custo. Com topicId, preenche a pauta planejada e herda a data. Vai para revisão a não ser que submit seja false; o projeto decide se o trabalho vindo da API passa por revisão. Nunca publica.

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.

application/json
  1. body
projectId?string

O projeto, de Listar projetos. Um token de projeto preenche sozinho.

Tamanho1 <= length <= 64
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
topicId?string

De Listar pautas planejadas.

Tamanho1 <= length <= 64
submit?boolean
Padrãotrue

Corpo da resposta

Criado

application/json
  1. response
Exemplo de requisição
curl -X POST 'https://app.postline.com.br/api/v1/articles' \  -H 'Authorization: Bearer pl_live_…' \  -H 'Content-Type: application/json' \  -d '{  "title": "How to cut churn in the first 30 days",  "markdown": "## Why the first month matters\n\nMost churn happens before the second invoice.",  "submit": false}'
Exemplo de resposta
{  "id": "0b9c4e7a-5d1f-4c2e-9a8b-3f6e2d1c7b90",  "revision": 1,  "submitted": true,  "droppedImages": []}