Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Posts/Remover item do calendário

Remover item do calendário

DELETE /v1/posts/:id/items/:item escopo write

Tira do calendário um item que falhou (error) ou já foi cancelado. O item passa a canceled (o histórico fica) e some do calendário; se não sobrar item ativo, o post vira canceled. Itens enviados, agendados, em andamento e rascunhos não saem por aqui (use o cancelamento do post). Repetir é seguro. Devolve o post.

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Parâmetros

Nome Onde Descrição
id caminho Id do post.
item caminho Id do item do post (campo items[].id da resposta de GET /v1/posts/:id).
Idempotency-Key cabeçalho Chave de idempotência (1 a 255 caracteres visíveis, por exemplo um UUID). Repetir o MESMO pedido com a mesma chave, em até 24 h, devolve a resposta guardada (com Idempotent-Replayed: true) sem executar de novo; outro pedido com a mesma chave dá 422 idempotency_key_reuse; um pedido ainda em andamento dá 409 idempotency_in_progress. Erros 5xx não são guardados. A chave vale por workspace e por rota. Veja Repetir uma requisição.

Exemplo

curl -X DELETE "https://praeko.app/v1/posts/01KA3W2Y6H1RC5ZQ8M0T4VXE7N/items/01KA3W2Y6J9D3BNF7G2K5PQS8A" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "id": "01KA3W2Y6H1RC5ZQ8M0T4VXE7N",
  "title": "O teste que só falhava na segunda (versão final)",
  "state": "canceled",
  "type": "short",
  "kind": "video",
  "origin": "api",
  "media": {
    "video": "01KA3VQ7M2T9XE4HB8N5RZ6C0D",
    "cover": null
  },
  "texts": {
    "youtube": {
      "title": "O teste que só falhava na segunda",
      "text": "Um teste que passava de terça a domingo. O que ele escondia.\n\n#programação #testes"
    }
  },
  "tags": [
    "bastidores",
    "testes"
  ],
  "thumb": null,
  "items": [
    {
      "id": "01KA3W2Y6J9D3BNF7G2K5PQS8A",
      "network": "youtube",
      "channel": "01KA3V0R5D8M2WQ7X4HT9NZ1BF",
      "state": "canceled",
      "scheduledFor": "2026-11-10T20:30:00.000Z",
      "custom": true,
      "mode": "scheduled",
      "runAt": "2026-11-10T19:30:00.000Z",
      "warning": "YouTube 400 invalidDescription",
      "thumb": "01KA3VR1J5W8GD2KP7Y4FN9S3B"
    }
  ],
  "createdAt": "2026-11-07T14:02:11.482Z",
  "updatedAt": "2026-11-07T15:40:03.120Z",
  "actions": []
}

Devolve o post inteiro, já sem o item no calendário (GET /v1/calendar não lista item canceled). Se o item era o único ativo, state do post vira canceled.

Erros

Status code Quando
404 post_not_found O post não existe.
404 item_not_found O item não pertence a este post.
409 item_not_removable O item não está com erro nem cancelado (enviado, agendado, em andamento ou rascunho); details.state traz o estado.
422 idempotency_key_reuse A Idempotency-Key já foi usada com outro pedido (método, caminho, query ou corpo diferentes).
409 idempotency_in_progress Um pedido com a mesma Idempotency-Key ainda está em andamento (repita em instantes).
409 idempotency_response_too_large A resposta original passou de 256 KB e não foi guardada; consulte o recurso por GET.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.