Cancelar publicação

Cancela uma publicação ainda pendente sem remover o histórico.

POST/publications/{id}/cancelpublications:write

COMPORTAMENTO

A alteração é validada e persistida na conta da chave antes da resposta. Consulte o recurso retornado como fonte de verdade.

EFEITO

Pode alterar o recurso e emitir o evento de domínio correspondente.

REPETIÇÃO

Em falha de rede, confirme o estado do recurso antes de repetir. Refaça automaticamente apenas 429 e 5xx com backoff e jitter.

Solicitação

idstring · pathIdentificador do recurso.minLength 2 · maxLength 100obrigatório

reasonstring · bodyMotivo operacional do cancelamento.maxLength 500opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Escopopublications:write

Exemplo executável

curl

curl -X POST 'https://achadu.com/api/v1/publications/resource_id/cancel' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "reason": "string"
}'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json

{
  "data": {
    "id": "pub_01J...",
    "state": "queued",
    "group_id": "grp_01J...",
    "offer_id": "off_01J...",
    "error": null
  },
  "request_id": "req_01J..."
}

200Operação concluída.

400Parâmetro, corpo ou transição inválida.

401Chave ausente, inválida, expirada ou revogada.

402O plano da conta não libera esta interface.

403A chave precisa do escopo publications:write.

404Recurso inexistente nesta conta.

409O estado atual impede esta operação.

413O corpo JSON ultrapassa 128 KB.

429A janela de 120 solicitações por minuto foi excedida.

Cancelar publicação

Solicitação

Exemplo executável

Resposta e erros

Operações relacionadas